attacca
Agents

Delete an agent

Refused while the agent still has chats, jobs, schedules, or cards pointing at it — reassign or delete those first.

DELETE
/v1/agents/{agent_id}

Refused while the agent still has chats, jobs, schedules, or cards pointing at it — reassign or delete those first.

Authorization

api_key agents:write
AuthorizationBearer <token>

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

In: header

Scope: agents:write

Path Parameters

agent_id*string

Agent id

Formatuuid

Response Body

application/json

application/json

application/json

curl -X DELETE "https://example.com/v1/agents/497f6eca-6276-4993-bfeb-53cbbbba6f08"
Empty