curl --request GET \
--url https://davinci-app.com/api/v2/agent/models \
--header 'Authorization: Bearer <token>'available = client.agent_models.list()
print("Default:", available.default_model)
for model in available.models:
print(model.key, model.name)
print(model.options)
const available = await client.agentModels.list();
console.log('Default:', available.defaultModel);
for (const model of available.models) {
console.log(model.key, model.name);
console.log(model.options);
}
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://davinci-app.com/api/v2/agent/models', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"defaultModel": "<string>",
"models": [
{
"key": "<string>",
"name": "<string>",
"isDefault": true,
"options": [
{
"key": "<string>",
"label": "<string>",
"description": "<string>",
"type": "enum",
"defaultValue": "<string>",
"choices": [
{
"value": "<string>",
"label": "<string>",
"description": "<string>"
}
],
"trueLabel": "<string>",
"falseLabel": "<string>"
}
]
}
]
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}List available agent models
Returns the chat models available through the calling account’s effective LLM
profile. Pass a model’s key as model when sending an agent message, and
use its options definitions to build modelOptions.
The list can differ between accounts because subscription tier, tenant policy,
and an account-specific profile can all affect it. Omitting model from a
message uses defaultModel.
curl --request GET \
--url https://davinci-app.com/api/v2/agent/models \
--header 'Authorization: Bearer <token>'available = client.agent_models.list()
print("Default:", available.default_model)
for model in available.models:
print(model.key, model.name)
print(model.options)
const available = await client.agentModels.list();
console.log('Default:', available.defaultModel);
for (const model of available.models) {
console.log(model.key, model.name);
console.log(model.options);
}
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://davinci-app.com/api/v2/agent/models', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"defaultModel": "<string>",
"models": [
{
"key": "<string>",
"name": "<string>",
"isDefault": true,
"options": [
{
"key": "<string>",
"label": "<string>",
"description": "<string>",
"type": "enum",
"defaultValue": "<string>",
"choices": [
{
"value": "<string>",
"label": "<string>",
"description": "<string>"
}
],
"trueLabel": "<string>",
"falseLabel": "<string>"
}
]
}
]
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}Authorizations
Personal access token. The scopes granted at issuance determine both which
operations the key may call and the ceiling on the resource permissions it
can exercise. Each scope family is a ladder: projects:manage implies
projects:write and projects:read; cards:manage implies cards:write
and cards:read; and teams:manage implies teams:write and teams:read.
These are named API capability bundles, not blanket domain roles:
manage exposes only the permissions enumerated for that scope and never
bypasses the acting user's current role-based access.
Response
Models available to the calling account.
Key used when an agent message omits model.
Hide child attributes
Hide child attributes
Stable selector key accepted by SendAgentMessageRequest.model.
Human-readable model name.
Whether this is the account profile's default chat model.
Effective model controls and defaults available to this account.
Hide child attributes
Hide child attributes
Key to use in SendAgentMessageRequest.modelOptions.
enum, boolean A typed model option value.
Display label for true on a boolean option.
Display label for false on a boolean option.