API Reference
Create expertise request and send invitations
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
application/json- body
sectionScope*stringValue in
"all""selected"selectedSectionIds?array<string>expertEmails*array<string>Expertise request created
application/json- response
id*stringbriefId*stringbriefTitle*stringsectionScope*stringselectedSectionIds*array<string>questionsCount*numberstatus*stringinvitations*array<>One invitation per expert the request was sent to
createdAt*stringcurl -X POST 'https://api.getmint.ai/api/domains/string/content-briefs/string/expertise-requests' \ -H 'Content-Type: application/json' \ -d '{ "sectionScope": "all", "expertEmails": [ "jane.doe@acme.com", "john.smith@acme.com" ]}'{ "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "briefId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "briefTitle": "How to choose running shoes", "sectionScope": "all", "selectedSectionIds": [ "sec-1", "sec-2" ], "questionsCount": 12, "status": "pending", "invitations": [ { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "expertEmail": "jane.doe@acme.com", "status": "pending", "responsesCount": 0, "totalQuestions": 12, "remindersSentToday": 0, "completedAt": "2026-05-25T10:30:00.000Z", "createdAt": "2026-05-25T10:30:00.000Z" } ], "createdAt": "2026-05-25T10:30:00.000Z"}