Create a manual reoptimization brief (URL + keyword only, no GSC data)

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.

url*string

URL of the page to optimize (http/https only)

keyword*string

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

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/manual" \  -H "Content-Type: application/json" \  -d '{    "url": "https://example.com/blog/my-article",    "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 manual reoptimization brief (URL + keyword only, no GSC data)

Authorization

Path Parameters

Request Body

Response Body

`application/json`

Create a manual reoptimization brief (URL + keyword only, no GSC data)

Authorization

Path Parameters

Request Body

Response Body

`application/json`

Create a manual reoptimization brief (URL + keyword only, no GSC data)

201application/json

403

Create a manual reoptimization brief (URL + keyword only, no GSC data)

201application/json

403

`application/json`

`application/json`