Skip to main content
DELETE
Delete agent
Removes an agent. Phone numbers attached to this agent become inactive and stop routing calls.

Request

Response

200 OK:

Behaviour

  • Calls in progress finish. Deleting doesn’t interrupt active calls.
  • Phone numbers detach. Numbers previously attached become orphan — they won’t route calls until reassigned to another agent.
  • Historical data is kept. Past calls, transcripts, and recordings stay accessible via the API and dashboard.
  • agent_id becomes unusable. Future requests with this ID return 404.
Deletion is permanent. To temporarily disable an agent without losing setup, set is_active: false via Update agent instead.

Errors