Create a reoptimization brief from pasted page content (no crawl). For unpublished or gated pages.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

pageContent*string

Raw page content the user has pasted. Used in lieu of crawling — supports pages that are unpublished, gated, or otherwise un-crawlable. Markdown or plain text.

keyword*string

Target keyword for the page (2–200 characters, trimmed)

url?string

Optional reference URL for display only. Never fetched — paste briefs always operate on the supplied pageContent.

market?string

Target market code

Default"us"

language?string

Content language code

Default"en"

mode?string

Pipeline mode. full = SERP-based 7-step reoptimization; structural = lighter GEO refresh (dates, TL;DR, FAQ, comparison table) with no SERP work.

Default"full"

Value in"full" | "structural"

autoMode?boolean

When true, the brief auto-applies ALL recommendations and factual checks the moment the pipeline completes — no human review. Works with either mode. Best-effort: it consumes the configured CONTENT_GENERATION credit cost per recommendation applied, but if that credit check or the queue enqueue fails the brief is left at completed for manual optimize (it is not guaranteed to auto-optimize).

Defaultfalse

Response Body

`application/json`

curl -X POST "https://example.com/domains/string/content-studio-v2/reoptimization-briefs/paste" \  -H "Content-Type: application/json" \  -d '{    "pageContent": "# My article\\n\\n## Section 1\\n\\nLorem ipsum…",    "keyword": "how to optimize seo"  }'

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "opportunityPageUrl": "https://nike.com/air-max",
  "status": "completed",
  "source": "gsc",
  "mode": "full",
  "autoMode": false,
  "targetKeywords": [
    "best running shoes",
    "running shoes for flat feet"
  ],
  "language": "en",
  "currentStep": 8,
  "totalSteps": 8,
  "currentStepName": "generateBrief",
  "errorMessage": "Page crawl returned 404",
  "createdAt": "2026-05-25T10:30:00.000Z",
  "completedAt": "2026-05-25T10:35:00.000Z"
}

Empty

Create a reoptimization brief from pasted page content (no crawl). For unpublished or gated pages.

Authorization

Path Parameters

Request Body

Response Body

`application/json`

Create a reoptimization brief from pasted page content (no crawl). For unpublished or gated pages.

Authorization

Path Parameters

Request Body

Response Body

`application/json`

Create a reoptimization brief from pasted page content (no crawl). For unpublished or gated pages.

201application/json

403

Create a reoptimization brief from pasted page content (no crawl). For unpublished or gated pages.

201application/json

403

`application/json`

`application/json`