Skip to main content
DELETE
/
v1
/
agents
/
{agent_id}
Delete Ai Agent
curl --request DELETE \
  --url https://api.xpander.ai/v1/agents/{agent_id} \
  --header 'x-api-key: <api-key>'
{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}
Permanently delete an agent. This action cannot be undone.

​
Path Parameters

​
agent_id
string
required
Unique identifier of the agent to delete (UUID format)

​
Response

Returns 202 Accepted or 204 No Content on successful deletion.

​
Notes

  • All running tasks for this agent will be cancelled
  • Agent configuration and history will be permanently removed
  • This action cannot be undone
  • Associated knowledge bases and tools are not deleted
  • You can also delete agents through the web dashboard at https://app.xpander.ai

​
Example Request

curl -X DELETE -H "x-api-key: YOUR_API_KEY" \
  https://api.xpander.ai/v1/agents/11cf5b70-7743-4d5f-a739-3f94fef8ec0f

​
Example Response

HTTP/1.1 202 Accepted
Content-Type: application/json

null
The endpoint returns 202 Accepted to indicate the deletion request has been accepted and will be processed asynchronously.

Authorizations

​
x-api-key
string
header
required

API Key for authentication

Path Parameters

​
agent_id
string
required

Response

Successful Response