Delete an agent
Soft-deletes the agent and NULLs every reference to it (sessions, jobs, cronjobs, works, cards, user defaults). The agent's chats and schedules survive with a null agent; they can no longer be run or continued until a new agent is assigned.
Soft-deletes the agent and NULLs every reference to it (sessions, jobs, cronjobs, works, cards, user defaults). The agent's chats and schedules survive with a null agent; they can no longer be run or continued until a new agent is assigned.
Authorization
api_key agents:writeAn atk_-prefixed API key, created under Settings → API keys.
In: header
Scope: agents:write
Path Parameters
Agent id
uuidResponse Body
application/json
application/json
application/json
curl -X DELETE "https://example.com/v1/agents/497f6eca-6276-4993-bfeb-53cbbbba6f08"Update an agent PATCH
Only agents this account owns can be edited; a globally shared agent is read-only here.
List models GET
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.