Errors
agent_not_found
Agent not found.
| HTTP status | Type | Code |
|---|---|---|
| 404 | not_found_error | agent_not_found |
What it means
No agent with this id exists in your workspace, or it was deleted. List your agents with GET /agents and use one of the returned ids.
How to handle it
Check the ID in the path. It may be wrong, deleted, or belong to another workspace; the API answers 404 rather than revealing other workspaces’ data.
Example response
{
"detail": "Agent not found.",
"error": {
"type": "not_found_error",
"code": "agent_not_found",
"message": "Agent not found.",
"param": null,
"docUrl": "https://docs.callmitra.ai/errors/agent_not_found",
"requestId": "req_3f9c2a7d1b8e4c6a9f0e2d4b6a8c0e1f"
}
}Branch on error.code; it never changes once published. The message text can change. See Errors for the envelope.
Returned by
POST /api/v1/calls/— Place a callDELETE /api/v1/agents/{agent_id}— Delete an agentGET /api/v1/agents/{agent_id}— Get an agentPOST /api/v1/agents/{agent_id}/pause— Stop taking callsPOST /api/v1/agents/{agent_id}/publish— Publish the agent's draftPUT /api/v1/agents/{agent_id}/post-call-webhook— Set an agent's post-call webhookPOST /api/v1/agents/{agent_id}/go-live— Start taking callsPOST /api/v1/agents/{agent_id}/test-call— Place a test callPATCH /api/v1/agents/{agent_id}— Update an agent