Agents
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:writeAuthorizationBearer <token>
An atk_-prefixed API key, created under Settings → API keys.
In: header
Scope: agents:write
Path Parameters
agent_id*string
Agent id
Format
uuidResponse Body
application/json
application/json
application/json
curl -X DELETE "https://example.com/v1/agents/497f6eca-6276-4993-bfeb-53cbbbba6f08"Empty