List the models an agent can use
GET /api/agent-definitions/available-models
GET
/api/agent-definitions/available-models
Returns the models an agent created in the account can run on. Send a model’s id as model when you create or update an agent. An agent without a model runs on Automatic, where oHallo chooses the model. Requires the agents:read scope.
Authorizations
Section titled “Authorizations ”Responses
Section titled “ Responses ”The models an agent can use.
The models an agent created in the account can run on.
object
models
required
The models, in the order the dashboard lists them.
Array<object>
A model an agent can run on.
object
id
required
The value to send as model when an agent is created or updated.
string
Example
claude-sonnet-4-6 label
required
The model’s name, as the dashboard shows it.
string
Example
Claude Sonnet 4.6 family
required
The model family.
string
Example
claude-sonnet description
required
What the model is suited to.
string | null
Example
A balanced model: strong general intelligence with quick responses. A solid choice for most agents. contextWindowTokens
required
How many tokens the model reads in one request.
integer
Example
1000000 provider
required
The provider of the model, as the dashboard names it.
string
Example
Anthropic