Select article title from suggestions

POST

/api/domains/{domainId}/content-briefs/{briefId}/select-title

Authorization

headerAuthorizationBearer <token>

Session JWT signed with HS256. Verification pins the algorithm and rejects expired tokens, per RFC8725.

Path Parameters

domainId*string

Domain ID

briefId*string

Brief ID

Request Body

application/json

body

titleId?string

UUID of the selected title suggestion

customTitle?string

Custom title entered by the user

Length5 <= length <= 200

Response Body

Title selected successfully

application/json

response

id*string

Brief ID

keyword*string

Primary keyword

market*string

Target market code

language*string

Content language

targetArticleTitle?string

Target article title (selected or generated)

status*string

Current status

Value in"queued""running""pending_title_selection""completed""brief_editing""brief_ready""content_queued""content_generating""content_generated""failed""cancelled"

kanbanStatus?|

Kanban board column override (null = derived from pipeline status)

Value in"processing""briefs""contents""review""published"

currentStep*number

Current step number

totalSteps*number

Total steps

currentStepName?string

Current step name

detectedArticleType?string

Detected article type (once article type detection step completes)

Value in"guide""how_to""comparatif""definition"

createdAt*string

Creation date

completedAt?string

Completion date

errorMessage?string

Error message if failed

autopilotMode*boolean

Whether this brief was created in Autopilot mode

fromContentGap?boolean

Whether this brief was created from a content gap analysis

domainId*string

Domain ID

organizationId*string

Organization ID

serpData?

SERP data output

searchIntent?

Search intent analysis

personas?

Generated personas

keywordVolumes?

Keyword volume data

scrapedPages?array<string>

Scraped pages

articleTypeDetection?

Article type detection results

faqDetection?

FAQ detection results

titleAnalyses?array<string>

Title analysis results

filteredTitles?

Filtered titles

gapScan?

Gap scan results

topicClustering?

Topic clustering results

titleOrdering?

Title ordering results

topicAlignment?

Topic alignment results

titleSuggestions?

Title suggestions for human-in-the-loop selection

preBriefResearch?

Pre-brief research output (curated for frontend)

metadata?

Additional metadata

gapInsights?

Gap insights from content gap analysis

curl -X POST 'https://api.getmint.ai/api/domains/string/content-briefs/string/select-title' \  -H 'Content-Type: application/json' \  -d '{}'

{  "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,  "domainId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",  "organizationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",  "serpData": {    "organic": [      {        "position": 1,        "url": "https://nike.com/air-max",        "title": "Nike Air Max"      }    ]  },  "searchIntent": {    "intent": "informational",    "confidence": 0.92  },  "personas": {    "primary": "First-time marathon runner",    "age": "25-34"  },  "keywordVolumes": {    "best running shoes": 27000,    "running shoes for flat feet": 8100  },  "scrapedPages": [    {      "url": "https://nike.com/air-max",      "wordCount": 1840    }  ],  "articleTypeDetection": {    "type": "guide",    "confidence": 0.88  },  "faqDetection": {    "hasFaq": true,    "questions": [      "How do I pick the right size?"    ]  },  "titleAnalyses": [    {      "title": "How to choose running shoes",      "score": 0.81    }  ],  "filteredTitles": {    "kept": [      "How to choose running shoes"    ],    "removed": [      "Buy shoes now"    ]  },  "gapScan": {    "gaps": [      "Trail running",      "Pronation guide"    ]  },  "topicClustering": {    "clusters": [      {        "name": "Cushioning",        "size": 5      }    ]  },  "titleOrdering": {    "order": [      "How to choose running shoes",      "Best running shoes 2026"    ]  },  "topicAlignment": {    "aligned": true,    "coverage": 0.76  },  "titleSuggestions": {    "suggestions": [      "How to choose running shoes",      "Running shoe buying guide 2026"    ]  },  "preBriefResearch": {    "commonTopics": [      "cushioning",      "arch support"    ],    "keywordCount": 48  },  "metadata": {    "source": "content-gap",    "requestedBy": "jane.doe@acme.com"  },  "gapInsights": {    "topGap": "Trail running",    "percentage": 42  }}

POST

/api/domains/{domainId}/content-briefs/{briefId}/select-title

Authorization

headerAuthorizationBearer <token>

Session JWT signed with HS256. Verification pins the algorithm and rejects expired tokens, per RFC8725.

Path Parameters

domainId*string

Domain ID

briefId*string

Brief ID

Request Body

application/json

body

titleId?string

UUID of the selected title suggestion

customTitle?string

Custom title entered by the user

Length5 <= length <= 200

Response Body

Title selected successfully

application/json

response

id*string

Brief ID

keyword*string

Primary keyword

market*string

Target market code

language*string

Content language

targetArticleTitle?string

Target article title (selected or generated)

status*string

Current status

Value in"queued""running""pending_title_selection""completed""brief_editing""brief_ready""content_queued""content_generating""content_generated""failed""cancelled"

kanbanStatus?|

Kanban board column override (null = derived from pipeline status)

Value in"processing""briefs""contents""review""published"

currentStep*number

Current step number

totalSteps*number

Total steps

currentStepName?string

Current step name

detectedArticleType?string

Detected article type (once article type detection step completes)

Value in"guide""how_to""comparatif""definition"

createdAt*string

Creation date

completedAt?string

Completion date

errorMessage?string

Error message if failed

autopilotMode*boolean

Whether this brief was created in Autopilot mode

fromContentGap?boolean

Whether this brief was created from a content gap analysis

domainId*string

Domain ID

organizationId*string

Organization ID

serpData?

SERP data output

searchIntent?

Search intent analysis

personas?

Generated personas

keywordVolumes?

Keyword volume data

scrapedPages?array<string>

Scraped pages

articleTypeDetection?

Article type detection results

faqDetection?

FAQ detection results

titleAnalyses?array<string>

Title analysis results

filteredTitles?

Filtered titles

gapScan?

Gap scan results

topicClustering?

Topic clustering results

titleOrdering?

Title ordering results

topicAlignment?

Topic alignment results

titleSuggestions?

Title suggestions for human-in-the-loop selection

preBriefResearch?

Pre-brief research output (curated for frontend)

metadata?

Additional metadata

gapInsights?

Gap insights from content gap analysis

curl -X POST 'https://api.getmint.ai/api/domains/string/content-briefs/string/select-title' \  -H 'Content-Type: application/json' \  -d '{}'

{  "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,  "domainId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",  "organizationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",  "serpData": {    "organic": [      {        "position": 1,        "url": "https://nike.com/air-max",        "title": "Nike Air Max"      }    ]  },  "searchIntent": {    "intent": "informational",    "confidence": 0.92  },  "personas": {    "primary": "First-time marathon runner",    "age": "25-34"  },  "keywordVolumes": {    "best running shoes": 27000,    "running shoes for flat feet": 8100  },  "scrapedPages": [    {      "url": "https://nike.com/air-max",      "wordCount": 1840    }  ],  "articleTypeDetection": {    "type": "guide",    "confidence": 0.88  },  "faqDetection": {    "hasFaq": true,    "questions": [      "How do I pick the right size?"    ]  },  "titleAnalyses": [    {      "title": "How to choose running shoes",      "score": 0.81    }  ],  "filteredTitles": {    "kept": [      "How to choose running shoes"    ],    "removed": [      "Buy shoes now"    ]  },  "gapScan": {    "gaps": [      "Trail running",      "Pronation guide"    ]  },  "topicClustering": {    "clusters": [      {        "name": "Cushioning",        "size": 5      }    ]  },  "titleOrdering": {    "order": [      "How to choose running shoes",      "Best running shoes 2026"    ]  },  "topicAlignment": {    "aligned": true,    "coverage": 0.76  },  "titleSuggestions": {    "suggestions": [      "How to choose running shoes",      "Running shoe buying guide 2026"    ]  },  "preBriefResearch": {    "commonTopics": [      "cushioning",      "arch support"    ],    "keywordCount": 48  },  "metadata": {    "source": "content-gap",    "requestedBy": "jane.doe@acme.com"  },  "gapInsights": {    "topGap": "Trail running",    "percentage": 42  }}

Select article title from suggestions

AuthorizationCopy Anchor Link

Path ParametersCopy Anchor Link

Request BodyCopy Anchor Link

Response BodyCopy Anchor Link

Select article title from suggestions

AuthorizationCopy Anchor Link

Path ParametersCopy Anchor Link

Request BodyCopy Anchor Link

Response BodyCopy Anchor Link

Authorization

Path Parameters

Request Body

Response Body

Authorization

Path Parameters

Request Body

Response Body