Skip to main content

​
Overview

Delete an existing AI agent using its unique Agent ID. Once deleted, the agent can no longer be assigned to campaigns or receive calls.
Deleting an AI agent is permanent and cannot be undone.

​
Prerequisites

  • Bearer token for an authenticated workspace
  • Valid Agent ID
Use the Get Agents endpoint to retrieve the Agent ID before deleting an agent.

​
Path Parameters

​
string
required
Unique identifier of the AI agent to delete.

​
Request

​
string
required
Bearer token for authenticated workspace access.

​
Response

​
boolean
required
Indicates whether the request completed successfully.
​
integer
required
HTTP status code returned by the API.
​
string
required
Confirmation that the AI agent has been deleted.

​
Response Codes

​
Error Handling

  • 400 Bad Request – Invalid Agent ID format.
  • 401 Unauthorized – Missing or invalid Bearer token.
  • 403 Forbidden – You do not have permission to delete this agent.
  • 404 Not Found – No AI agent exists with the provided ID.
  • 500 Internal Server Error – Unexpected server error.

​
Common Use Cases

  • Remove agents that are no longer in use.
  • Clean up test or development agents.
  • Delete agents before recreating them with a new configuration.
Deleting an AI agent does not automatically delete associated Knowledge Bases, phone numbers, or campaign history.
Before deleting an agent, consider:
  • Exporting any required configuration.
  • Removing the agent from active campaigns.
  • Ensuring the agent is no longer assigned to production workflows.