Skip to main content
DELETE
/
v2
/
chat
/
agents
/
{id}
Delete agent
curl --request DELETE \
  --url https://api.agntix.ai/v2/chat/agents/{id} \
  --header 'x-api-key: <api-key>'
{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Authentication required.",
    "status": 401
  },
  "meta": {
    "requestId": "req_01j3m...",
    "timestamp": "2026-04-29T10:00:00Z"
  }
}
Every endpoint on this page requires either a Clerk-issued JWT (Authorization: Bearer <token>) or an organization API key (x-api-key: pk_…). Anonymous calls return 401 Unauthorized. See Authentication for the full setup.
Deleting an agent is permanent. The agent is detached from all phone numbers and call campaigns. Existing session history is retained but the agent can no longer be used for new conversations.

​
Code examples

curl -X DELETE https://api.agntix.ai/v2/chat/agents/a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
  -H "x-api-key: pk_live_••••"

​
Soft-delete alternative

If you want to pause an agent without losing it, set isActive: false instead:
curl
curl -X PATCH https://api.agntix.ai/v2/chat/agents/a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
  -H "x-api-key: pk_live_••••" \
  -H "Content-Type: application/json" \
  -d '{ "isActive": false }'
A 204 No Content response indicates the agent was successfully deleted.

Authorizations

​
x-api-key
string
header
required

Organization API key. Obtain from the dashboard. Format: pk_live_…

Path Parameters

​
id
string<uuid>
required

Response

Agent deleted.