Delete Agent

DELETE

chat

agents

{id}

Delete agent

curl --request DELETE \
  --url https://api.agntix.ai/v2/chat/agents/{id} \
  --header 'x-api-key: <api-key>'

const options = {method: 'DELETE', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.agntix.ai/v2/chat/agents/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Authentication required.",
    "status": 401
  },
  "meta": {
    "requestId": "req_01j3m...",
    "timestamp": "2026-04-29T10:00:00Z"
  }
}

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Agent not found.",
    "status": 404
  },
  "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_••••"

const agentId = 'a1b2c3d4-e5f6-7890-abcd-ef1234567890';

const res = await fetch(`https://api.agntix.ai/v2/chat/agents/${agentId}`, {
  method: 'DELETE',
  headers: { 'x-api-key': 'pk_live_••••' },
});

if (res.status === 204) {
  console.log('Agent deleted successfully.');
}

import httpx

agent_id = "a1b2c3d4-e5f6-7890-abcd-ef1234567890"

response = httpx.delete(
    f"https://api.agntix.ai/v2/chat/agents/{agent_id}",
    headers={"x-api-key": "pk_live_••••"},
)
assert response.status_code == 204

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

string<uuid>

required

Response

Agent deleted.

Delete agent

curl --request DELETE \
  --url https://api.agntix.ai/v2/chat/agents/{id} \
  --header 'x-api-key: <api-key>'

const options = {method: 'DELETE', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.agntix.ai/v2/chat/agents/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Authentication required.",
    "status": 401
  },
  "meta": {
    "requestId": "req_01j3m...",
    "timestamp": "2026-04-29T10:00:00Z"
  }
}

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Agent not found.",
    "status": 404
  },
  "meta": {
    "requestId": "req_01j3m...",
    "timestamp": "2026-04-29T10:00:00Z"
  }
}

Overview

Agents

Chat

Voice

Tools

Phone Numbers

Code examples

Soft-delete alternative

Authorizations

Path Parameters

Response

​Code examples

​Soft-delete alternative

Authorizations

Path Parameters

Response

Code examples

Soft-delete alternative