Skip to main content
DELETE

Request

Permanently delete an AI voice agent. This action cannot be undone.
Deleting an agent is permanent. All associated configuration will be lost. Active calls using this agent will not be affected, but no new calls can be initiated.

Headers

string
required
Bearer token for authentication. Format: Bearer YOUR_API_KEY

Path Parameters

string
required
The unique identifier of the agent to delete

Response

Returns a confirmation of deletion.
string
The ID of the deleted agent
boolean
Always true on success

Error Codes

Best Practices

Before deleting an agent:
  1. Check for active calls - Ensure no calls are currently in progress
  2. Export configuration - Save the agent’s system prompt and settings if you might need them later
  3. Update integrations - Remove references to this agent from webhooks and automations