Get available models by type
Returns a flattened list of individual AI models of the requested type, suitable for use in selection dropdowns and model-picker UIs.
Each provider configuration entry may specify multiple comma-separated model names; this endpoint expands those into one object per model name so callers receive a flat, enumerable collection.
Flattening rules:
- Only the first model in a multi-model provider entry is marked isDefault: true; all subsequent models from the same entry get false.
- modelFriendlyName is included only when the provider entry contains exactly one model name (not a comma-separated list).
- When no providers of the requested type are configured the endpoint still returns HTTP 200 with an empty models array — this is not an error.
Access control: requires a valid bearer token. For OAuth tokens the config:read scope must be present; regular JWT bearer tokens pass through without scope enforcement.
Path parameters
Type of AI model
Category of AI model to retrieve.
Must be one of: llm, embedding, ocr, slm, reasoning, multiModal, imageGeneration, tts, stt.
Response
Available models retrieved successfully.
An empty models array (with HTTP 200) is returned when no providers of the requested type have been configured — treat this as a valid, empty state, not an error.
Example response
{
"status": "success",
"message": "Found 2 llm models",
"models": [
{
"provider": "azureOpenAI",
"modelName": "gpt-5.4-mini",
"modelKey": "f3a4b5b6-5b6c-4e85-9097-3202cfe696fc",
"isMultimodal": true,
"isReasoning": true,
"isDefault": true,
"modelFriendlyName": "Reasoning model"
}
]
}