Agents
Get an agent
Authorization
api_key agents:readAuthorizationBearer <token>
An atk_-prefixed API key, created under Settings → API keys.
In: header
Scope: agents:read
Path Parameters
agent_id*string
Agent id
Format
uuidResponse Body
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/agents/497f6eca-6276-4993-bfeb-53cbbbba6f08"{ "can_manage_agents": true, "created_at": "2019-08-24T14:15:22Z", "description": "string", "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "is_default": true, "name": "string", "owner_user_id": "65139110-7c3c-4777-b692-80c218be3b9d", "prompt_ids": [ "string" ], "provider_id": "fe3d49af-4061-436b-ae60-f7044f252a44", "supports_image": true, "temperature": 0, "tool_plugin_ids": [ "string" ], "updated_at": "2019-08-24T14:15:22Z", "version": 0}Create an agent POST
`model` is the opaque handle `GET /v1/models` returns for this account. `provider_id` is normally unnecessary: a catalogued model names its own provider, and that is the only kind of model this surface can reach without an endpoint of its own. A provider the account cannot reference is rejected, which is what stops an agent from being pointed at another account's credentials.
Update an agent PATCH
Only agents this account owns can be edited; a globally shared agent is read-only here.