Skip to Content
CallMitraDocs
Errors

agent_not_found

Agent not found.

HTTP statusTypeCode
404not_found_erroragent_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 call
  • DELETE /api/v1/agents/{agent_id} — Delete an agent
  • GET /api/v1/agents/{agent_id} — Get an agent
  • POST /api/v1/agents/{agent_id}/pause — Stop taking calls
  • POST /api/v1/agents/{agent_id}/publish — Publish the agent's draft
  • PUT /api/v1/agents/{agent_id}/post-call-webhook — Set an agent's post-call webhook
  • POST /api/v1/agents/{agent_id}/go-live — Start taking calls
  • POST /api/v1/agents/{agent_id}/test-call — Place a test call
  • PATCH /api/v1/agents/{agent_id} — Update an agent

On this page