The models one local agent lists, in the agent's own ids. Empty when the agent lists none: the picker then shows no model level under it.
API reference sections
Schema
AgentModelsResponse
Type object
Shape
| Field | Type | Description |
|---|---|---|
| providerrequired | AiProviderId | Extensible provider token such as openai, ollama, or koru. |
| modelsrequired | array of AgentModelView | |
| modes | array of AgentModeView | The agent's approval modes (koru-ai D7), in its order, with its own ids. Empty when it offers none: a client then shows no mode control. |
| default_mode | string or null | The mode the agent reports it starts in - the one a chat that chose none runs in. Absent when the agent does not say. |
| levels_per_turn | boolean | A begun chat's level can change, applied from its next message (koru-ai D70): the agent's session host takes a level with each message. |
| models_per_turn | boolean | A begun chat's model can move to another of the agent's models, applied from its next message: the agent's session host takes a model with each message (session protocol v22). |
{
"provider": "string",
"models": [
{
"id": "string",
"group": "string",
"name": "string",
"description": "string",
"group_name": "string",
"legacy": false,
"reasoning": {
"kind": "unsupported"
},
"context": {
"id": "string",
"tokens": 0
},
"fast": {
"on_by_default": false
}
}
],
"modes": [
{
"id": "string",
"name": "string",
"description": "string"
}
],
"default_mode": "string",
"levels_per_turn": false,
"models_per_turn": false
}The contract has no example values, so example bodies are generated from each schema: every field is shown with a placeholder of its type.
Used by
Generated from contract version 1. Last updated .