Skip to main content
DELETE
/
v1
/
chat
/
tools
/
{id}
Delete tool
curl --request DELETE \
  --url https://api.agntix.ai/v1/chat/tools/{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 a tool automatically detaches it from all agents that currently use it. The change takes effect on the next conversation turn. This action cannot be undone.

Code examples

curl -X DELETE https://api.agntix.ai/v1/chat/tools/550e8400-e29b-41d4-a716-446655440000 \
  -H "x-api-key: pk_live_••••"
A 204 No Content response indicates the tool 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

Tool deleted.