API Reference
Trigger content generation for a brief
POST
header
AuthorizationBearer <token>Session JWT signed with HS256. Verification pins the algorithm and rejects expired tokens, per RFC8725.
domainId*stringDomain ID
briefId*stringBrief ID
Idempotency-Key?stringOne key per user action, 1 to 255 printable ASCII characters. A retry that sends the same key and the same request gets the first response back, with the Idempotent-Replayed header, instead of running again.
application/json- body
wordCountOverride?numberOverride word count target (500-5000)
generateTitle?booleanGenerate and auto-select a title before content generation (used by Skip & Generate)
Generation started
application/json- response
briefId*stringstatus*stringarticleId?stringprogress?numbercurrentStep?stringerror?stringcurl -X POST 'https://api.getmint.ai/api/domains/string/content-briefs/string/content/generate' \ -H 'Content-Type: application/json' \ -d '{}'{ "briefId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "status": "running", "articleId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "progress": 60, "currentStep": "Generating sections", "error": "Source crawl timed out"}