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>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.xpander.ai/llms.txt

Use this file to discover all available pages before exploring further.

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 HTTP 202 Accepted with body null on successful deletion.

​
Example Request

curl -X DELETE -H "x-api-key: <your-api-key>" \
  https://api.xpander.ai/v1/agents/<agent-id>

​
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.

​
Notes

  • All running tasks for this agent will be cancelled
  • Agent configuration and execution history will be permanently removed
  • This action cannot be undone
  • Associated knowledge bases and tools are not deleted (they remain in your organization)
  • You can also delete agents through the web dashboard at https://app.xpander.ai
  • An agent can only be deleted if the deletable field is true (use Get Agent to check)

Authorizations

​
x-api-key
string
header
required

API Key for authentication

Path Parameters

​
agent_id
string
required

Response

Successful Response