Skip to Content
CallMitraDocs
API referenceAgents

Start taking calls

Switches the agent on (`takingCalls: true`, `rosterState: live`). It needs a phone number assigned to the agent. A waiting draft (or a never-published agent) is published first, with the same checks as publishAgent. When a rule fails (no phone number, archived agent, draft breaks a publish rule) the call is refused with `agent_state_blocked` and a message naming what is missing.

POST
/api/v1/agents/{agent_id}/go-live

Switches the agent on (takingCalls: true, rosterState: live). It needs a phone number assigned to the agent. A waiting draft (or a never-published agent) is published first, with the same checks as publishAgent. When a rule fails (no phone number, archived agent, draft breaks a publish rule) the call is refused with agent_state_blocked and a message naming what is missing.

Authorization

headerX-API-Key<token>

Create in the console: Settings → API & webhooks.

Path Parameters

agent_id*Agent Id

Response Body

OK

application/json
  1. response

One agent.

agent*

An AI agent: its live configuration, draft, status and numbers.

success?Success

Always true on success.

Defaulttrue
[key: string]?any
Example Request
curl -X POST 'https://api.callmitra.ai/api/v1/agents/string/go-live'
Example Response
{  "agent": {    "id": "3f0c2a9e-6a51-4c6e-9a3e-2d1b7c4e8f10",    "name": "Priya",    "rosterState": "live",    "status": "published",    "takingCalls": true,    "unpublishedChanges": false  },  "success": true}