API Reference
Get AI model selection for a topic
Returns the topic-level override, the effective models after the topic → domain → organization → plan-default fallback chain, and the models available to the plan.
GET
header
X-API-Key<token>API Key for programmatic access
domainId*stringDomain identifier
topicId*stringTopic identifier
Topic model selection and fallback state
application/json- response
selectedModels?array<string>Topic-level override; empty when the topic inherits from its parents.
effectiveModels?array<string>Models the pipeline will run for this topic after fallback resolution.
effectiveSelectableModels?array<string>effectiveModels mapped back to the selectable (availableModels) id space, for pre-checking selection UIs.
source?stringWhich fallback-chain layer produced effectiveModels.
Value in
"topic""domain""organization""plan-default"fallbackToParent?booleandomainSelectedModels?array<string>organizationSelectedModels?array<string>modelFallbacks?array<>Substitutions applied to stale stored model ids.
replacementModels?array<>Metadata for replacement targets that are internal and therefore absent from availableModels.
maxModels?numberavailableModels?array<>curl -X GET 'https://api.getmint.ai/api/domains/string/topics/string/models'{ "selectedModels": [ "openai-gpt5" ], "effectiveModels": [ "openai-gpt5" ], "effectiveSelectableModels": [ "openai-gpt5" ], "source": "topic", "fallbackToParent": false, "domainSelectedModels": [], "organizationSelectedModels": [ "openai-gpt5", "anthropic-claude-4.5-sonnet" ], "modelFallbacks": [], "replacementModels": [], "maxModels": 3, "availableModels": [ { "id": "chatgpt", "name": "ChatGPT", "brand": "OpenAI", "enabled": true, "webAccess": true, "tier": 2, "fanOutQueriesSupported": true, "availability": { "verifiedMarkets": [ "US" ], "blockedMarkets": [], "blockedRegions": [], "sourcelessMarkets": [], "sourcelessRegions": [] } } ]}