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>'
{
  "message": "Agent deletion initiated",
  "agent_id": "93a1cd50-2af0-452a-99a0-6e1f1b14fb29"
}
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