attacca
Agents

List models

The models this account may point an agent at, as an `id` and a `name`. Pass the `id` as `model` when creating or updating an agent. `id` is an opaque handle rather than a model name, and deliberately so: which endpoint serves it, what the vendor calls it, and what it costs per token are not part of this surface. Two accounts pointed at the same catalog entry receive the same handle, so it is safe to store.

GET
/v1/models

The models this account may point an agent at, as an id and a name. Pass the id as model when creating or updating an agent.

id is an opaque handle rather than a model name, and deliberately so: which endpoint serves it, what the vendor calls it, and what it costs per token are not part of this surface. Two accounts pointed at the same catalog entry receive the same handle, so it is safe to store.

Authorization

api_key agents:read
AuthorizationBearer <token>

An atk_-prefixed API key, created under Settings → API keys.

In: header

Scope: agents:read

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/v1/models"
[  {    "cached_input_usd_per_1m": 0,    "context_window": 0,    "description": "string",    "id": "string",    "input_usd_per_1m": 0,    "model": "string",    "name": "string",    "output_usd_per_1m": 0,    "provider_id": "fe3d49af-4061-436b-ae60-f7044f252a44",    "provider_slug": "string",    "supports_audio": true,    "supports_image": true,    "uses": [      "string"    ],    "visibility": "string"  }]