Skip to content

List the model backends. Secrets show their last 4 characters only (SDD §14.1).

GET
/admin/backends
curl --request GET \
--url https://example.com/api/v1/admin/backends

The backends.

Media typeapplication/json
object
items
required
Array<object>
object
id
required
string format: uuid
kind
required
string
Allowed values: openai anthropic openrouter deepseek agent_cli
name
required
string
has_secret
required
boolean
secret_last4
required
string
base_url
string
preset
string
command
Array<string>
prompt_via
string
roles
required

The roles that use this backend.

Array<string>
Example
{
"items": [
{
"kind": "openai"
}
]
}

An error.

Media typeapplication/problem+json

RFC 9457 problem details with a stable code.

object
type
required
string
title
required
string
status
required
integer
detail
string
instance
string
code
required

A stable machine-readable error code.

string
Examplegenerated
{
"type": "example",
"title": "example",
"status": 1,
"detail": "example",
"instance": "example",
"code": "example"
}