Trillet AI logo

Delete Call Agent

Delete an existing agent

DELETEhttps://api.trillet.ai/v1/api/agents/{agentId}

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-idstringrequired

Workspace identifier for the API.

Path Parameters

agentIdstringrequired

The 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

StatusBodyWhen
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