API Reference
Create or update a gap for a (topic, prompt) pair
POST
header
X-API-Key<token>API Key for programmatic access
domainId*unknownDomain (brand) ID
application/json- body
topicId*stringprompt*stringlinkedActionIds?array<string>The upserted gap
application/json- response
id*stringorganizationId*stringdomainId*stringtopicId*stringprompt*stringlinkedActionIds*array<string>coverageStatus*stringValue in
"pending""in_progress""covered"createdAt*stringFormat
date-timeupdatedAt*stringFormat
date-timecurl -X POST 'https://api.getmint.ai/api/domains/{domainId}/gaps' \ -H 'Content-Type: application/json' \ -d '{ "topicId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "prompt": "What are the best running shoes for marathon training?"}'{ "id": "Ck2ZfQ0iJ4vQ9pXk3nHtR5sT7vW9yBdcefgHiJkLmno", "organizationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "domainId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "topicId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "prompt": "What are the best running shoes for marathon training?", "linkedActionIds": [ "robots-allow-ai", "add-llms-txt" ], "coverageStatus": "in_progress", "createdAt": "2026-05-25T10:30:00.000Z", "updatedAt": "2026-05-25T10:30:00.000Z"}