Skip to main content
DELETE
/
v1
/
agents
/
{agentId}
curl -X DELETE https://api.telzino.com/v1/agents/123e4567-e89b-12d3-a456-426614174000 \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

{
  "success": true,
  "message": "Agent deleted successfully"
}
This action cannot be undone. The agent and all its configuration will be permanently deleted.

​
Path Parameters

​
agentId
string
required
The unique identifier of the agent to delete (UUID format)
curl -X DELETE https://api.telzino.com/v1/agents/123e4567-e89b-12d3-a456-426614174000 \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

{
  "success": true,
  "message": "Agent deleted successfully"
}

​
What Gets Deleted

When you delete an agent, the following are removed:
  • Agent configuration (name, prompts, voice settings, etc.)
  • Extension configurations (webhook tools, MCP servers)
  • Integration configurations (calendar, modmed connections)
  • SIP registration data (if configured)
Call logs are NOT deleted. Historical call transcripts and recordings remain accessible for reporting and compliance purposes.

​
Alternative: Deactivate Instead

If you want to temporarily disable an agent without deleting it, use the Update Agent endpoint to set status to inactive: 
curl -X PUT https://api.telzino.com/v1/agents/{agentId} \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"status": "inactive"}'