Delete Call Agent
Delete an existing agent
DELETE
The agent is soft-deleted: it disappears from the API and the dashboard, and support can recover it.
Deleting an agent does not touch the call flow that uses it. That flow keeps pointing at the deleted agent and stops working. To remove a flow and its agent together, delete the call flow instead.
Headers
x-workspace-idstringrequiredWorkspace identifier for the API.
Path Parameters
agentIdstringrequiredThe unique identifier of the agent to delete
Response
200 with the agent as it was just before it was deleted, in the same shape as Get Call Agent.
Errors
| Status | Body | When |
|---|---|---|
400 | {"error": "Workspace ID is required"} | No x-workspace-id |
404 | {"error": "Agent not found or does not belong to the workspace"} | No agent with this ID in the workspace, including one already deleted |
500 | {"error": "..."} | Unexpected server error |
{
"_id": "d5d5d5d5d5d5d5d5d5d5d5d5",
"workspaceId": "d1d1d1d1d1d1d1d1d1d1d1d1",
"name": "Customer Support Agent",
"ttsModel": {
"provider": "rime",
"voiceId": "mistv3_wildflower",
"name": "Wildflower",
"language": "en",
"rimeModel": "mistv3"
},
"llmModel": "platform-llm",
"type": "voice",
"status": "ready",
"phoneNumberIds": [],
"activeSessions": [],
"createdAt": "2026-10-29T10:00:00.000Z",
"updatedAt": "2026-10-29T10:00:00.000Z"
}Last updated on