Skip to main content
DELETE
/
v1
/
agents
/
{agent_id}
curl -X DELETE https://api.ringyo.ai/v1/agents/agent_abc123 \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "id": "agent_abc123",
  "deleted": true
}

​
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

​
Authorization
string
required
Bearer token for authentication. Format: Bearer YOUR_API_KEY

​
Path Parameters

​
agent_id
string
required
The unique identifier of the agent to delete

​
Response

Returns a confirmation of deletion.
​
id
string
The ID of the deleted agent
​
deleted
boolean
Always true on success
curl -X DELETE https://api.ringyo.ai/v1/agents/agent_abc123 \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "id": "agent_abc123",
  "deleted": true
}

​
Error Codes

CodeDescription
agent_not_foundThe specified agent_id does not exist
agent_in_useAgent has active calls and cannot be deleted
unauthorizedYou don’t have permission to delete this agent

​
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