API ReferenceReferenceAgents
Delete an agent
Permanently deletes the agent, its draft and every published version. Cannot be undone. Requires the agents:write scope; a personal key also needs the admin role, the same rule as the dashboard.
Authorization
apiKey AuthorizationBearer <token>
An organization API key, created from a Portal's Webhooks page (Provisioning API card). The secret is shown once at creation and stored only as a hash. Keys are organization-wide and carry scopes (end_users:read, end_users:write). Rate limit: 120 requests per minute per key (sliding 60-second window).
In: header
Path Parameters
agentId*string
Format
uuidResponse Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X DELETE "https://example.com/agents/497f6eca-6276-4993-bfeb-53cbbbba6f08"{ "deleted": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "kind": "agent", "type": "string", "name": "string", "slug": "string", "description": "string", "published": true, "productionVersionId": "a45124a6-f1ae-495a-9d4c-946315091da1", "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z" }}