Create a new brief and start pipeline

Authorization

AuthorizationBearer <token>

In: header

Path Parameters

domainId*string

Domain ID

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

`application/json`

curl -X POST "https://example.com/api/domains/string/content-briefs" \  -H "Content-Type: application/json" \  -d '{    "keyword": "content marketing strategy"  }'

{  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",  "keyword": "best running shoes",  "market": "US",  "language": "en",  "targetArticleTitle": "How to choose running shoes",  "status": "completed",  "kanbanStatus": "briefs",  "currentStep": 14,  "totalSteps": 14,  "currentStepName": "title_suggestions",  "detectedArticleType": "guide",  "createdAt": "2026-05-25T10:30:00.000Z",  "completedAt": "2026-05-25T10:35:00.000Z",  "errorMessage": "SERP provider returned no results",  "autopilotMode": false,  "fromContentGap": true}

Authorization

AuthorizationBearer <token>

In: header

Path Parameters

domainId*string

Domain ID

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

keyword*string

Primary keyword for the brief

Length2 <= length <= 200

market?string

Target market code

Default"us"

language?string

Content language code

Default"en"

targetArticleTitle?string

Custom article title (optional, generated if not provided)

autopilotMode?boolean

Autopilot mode — auto-select first title, initialize document, and trigger content generation after pipeline completes

Defaultfalse

gapInsights?

Gap insights from content gap analysis (common topics and content structures)

blankMode?boolean

Skip the AI research pipeline and create an empty brief ready for manual editing. No credits consumed.

Defaultfalse

Response Body

`application/json`

curl -X POST "https://example.com/api/domains/string/content-briefs" \  -H "Content-Type: application/json" \  -d '{    "keyword": "content marketing strategy"  }'

{  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",  "keyword": "best running shoes",  "market": "US",  "language": "en",  "targetArticleTitle": "How to choose running shoes",  "status": "completed",  "kanbanStatus": "briefs",  "currentStep": 14,  "totalSteps": 14,  "currentStepName": "title_suggestions",  "detectedArticleType": "guide",  "createdAt": "2026-05-25T10:30:00.000Z",  "completedAt": "2026-05-25T10:35:00.000Z",  "errorMessage": "SERP provider returned no results",  "autopilotMode": false,  "fromContentGap": true}

Create a new brief and start pipeline

201application/json

400

403

Create a new brief and start pipeline

201application/json

400

403

`application/json`

`application/json`