Skip to main content
DELETE
Delete Ai Agent
Permanently delete an agent. This action cannot be undone.

Path Parameters

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

Response

Returns HTTP 202 Accepted with body null on successful deletion.

Example Request

Example Response

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