API Reference
Create a new comment thread on article text
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
articleId*stringArticle ID
Comment thread created
application/json- response
id*stringPublic UUID of the thread
articleId*stringUUID of the generated article the thread is anchored in
briefId*stringUUID of the content brief the article belongs to
domainId*stringUUID of the domain
organizationId*stringUUID of the owning organization
anchorText*stringThe article text the thread is attached to
anchorSectionHeading*stringHeading of the section containing the anchor
status*stringWhether the thread is still open
Value in
"open""resolved"comments*array<>Messages in the thread, oldest first
createdAt*stringWhen the thread was opened
Format
date-timeupdatedAt*stringWhen the thread last changed
Format
date-timecurl -X POST 'https://api.getmint.ai/api/domains/string/content-briefs/string/articles/string/comments'{ "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "articleId": "7c9e6679-7425-40de-944b-e07fc1f90ae7", "briefId": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d", "domainId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "organizationId": "7c9e6679-7425-40de-944b-e07fc1f90ae7", "anchorText": "running shoes wear out after 500 km", "anchorSectionHeading": "When to replace your shoes", "status": "open", "comments": [ { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "userId": "7c9e6679-7425-40de-944b-e07fc1f90ae7", "userName": "Jane Doe", "content": "Can we cite a source for this claim?", "createdAt": "2026-05-25T10:30:00.000Z" } ], "createdAt": "2026-05-25T10:30:00.000Z", "updatedAt": "2026-05-25T10:30:00.000Z"}