Create a reoptimization brief from pasted page content (no crawl). For unpublished or gated pages.
AuthorizationBearer <token>Session JWT signed with HS256. Verification pins the algorithm and rejects expired tokens, per RFC8725.
domainId*stringDomain ID
application/json- body
pageContent*stringRaw 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*stringTarget keyword for the page (2–200 characters, trimmed)
url?stringOptional reference URL for display only. Never fetched — paste briefs always operate on the supplied pageContent.
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/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"}