Create a manual reoptimization brief (URL + keyword only, no GSC data)
AuthorizationBearer <token>Session JWT signed with HS256. Verification pins the algorithm and rejects expired tokens, per RFC8725.
domainId*stringDomain ID
application/json- body
url*stringURL of the page to optimize (http/https only)
keyword*stringTarget keyword for the page (2–200 characters, trimmed)
market?stringTarget market code
"us"language?stringContent language code
"en"mode?stringPipeline mode. full = SERP-based 7-step reoptimization; structural = lighter GEO refresh (dates, TL;DR, FAQ, comparison table) with no SERP work.
"full""full""structural"autoMode?booleanWhen 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).
falseBrief created
application/json- response
id*stringopportunityPageUrl*stringstatus*stringsource*string"gsc""manual""paste"mode*string"full""structural"autoMode*booleantargetKeywords*array<string>language?stringcurrentStep*numbertotalSteps*numbercurrentStepName?stringerrorMessage?stringcreatedAt*stringcompletedAt?stringcurl -X POST 'https://api.getmint.ai/api/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"}