curl -X DELETE https://api.telzino.com/v1/agents/123e4567-e89b-12d3-a456-426614174000 \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
const agentId = '123e4567-e89b-12d3-a456-426614174000';
const response = await fetch(`https://api.telzino.com/v1/agents/${agentId}`, {
method: 'DELETE',
headers: { 'Authorization': 'Bearer YOUR_ACCESS_TOKEN' }
});
const { success, message } = await response.json();
console.log(message); // "Agent deleted successfully"
import requests
agent_id = '123e4567-e89b-12d3-a456-426614174000'
response = requests.delete(
f'https://api.telzino.com/v1/agents/{agent_id}',
headers={'Authorization': 'Bearer YOUR_ACCESS_TOKEN'}
)
result = response.json()
print(result['message']) # "Agent deleted successfully"
{
"success": true,
"message": "Agent deleted successfully"
}
{
"error": "forbidden",
"error_description": "Access denied"
}
{
"error": "not_found",
"error_description": "Agent not found or access denied"
}
Agents
Delete Agent
Deletes an existing agent
DELETE
/
v1
/
agents
/
{agentId}
curl -X DELETE https://api.telzino.com/v1/agents/123e4567-e89b-12d3-a456-426614174000 \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
const agentId = '123e4567-e89b-12d3-a456-426614174000';
const response = await fetch(`https://api.telzino.com/v1/agents/${agentId}`, {
method: 'DELETE',
headers: { 'Authorization': 'Bearer YOUR_ACCESS_TOKEN' }
});
const { success, message } = await response.json();
console.log(message); // "Agent deleted successfully"
import requests
agent_id = '123e4567-e89b-12d3-a456-426614174000'
response = requests.delete(
f'https://api.telzino.com/v1/agents/{agent_id}',
headers={'Authorization': 'Bearer YOUR_ACCESS_TOKEN'}
)
result = response.json()
print(result['message']) # "Agent deleted successfully"
{
"success": true,
"message": "Agent deleted successfully"
}
{
"error": "forbidden",
"error_description": "Access denied"
}
{
"error": "not_found",
"error_description": "Agent not found or access denied"
}
This action cannot be undone. The agent and all its configuration will be permanently deleted.
Path Parameters
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"
const agentId = '123e4567-e89b-12d3-a456-426614174000';
const response = await fetch(`https://api.telzino.com/v1/agents/${agentId}`, {
method: 'DELETE',
headers: { 'Authorization': 'Bearer YOUR_ACCESS_TOKEN' }
});
const { success, message } = await response.json();
console.log(message); // "Agent deleted successfully"
import requests
agent_id = '123e4567-e89b-12d3-a456-426614174000'
response = requests.delete(
f'https://api.telzino.com/v1/agents/{agent_id}',
headers={'Authorization': 'Bearer YOUR_ACCESS_TOKEN'}
)
result = response.json()
print(result['message']) # "Agent deleted successfully"
{
"success": true,
"message": "Agent deleted successfully"
}
{
"error": "forbidden",
"error_description": "Access denied"
}
{
"error": "not_found",
"error_description": "Agent not found or access denied"
}
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 setstatus 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"}'