Place a test call
Calls `destination` from one of your numbers so you can hear the agent. Not a campaign call and not billed; free plans have a test-call allowance.
Calls destination from one of your numbers so you can hear the agent. Not a campaign call and not billed; free plans have a test-call allowance.
X-API-Key<token>Create in the console: Settings → API & webhooks.
agent_id*Agent Idapplication/json- body
Place a test call from one of your numbers.
destination*DestinationE.164 or local number to dial.
3 <= lengthdynamicValues?Values for the script's placeholders, e.g. {"name": "Asha"}.
phoneNumberId*PhonenumberidYour phone number id to call from.
1 <= lengthOK
application/json- response
The test call was placed.
callId?|Id of the call; read it with getCall.
message?|Human-readable status.
phoneNumber?|Number being dialed, in E.164 format.
success?SuccessAlways true on success.
true[key: string]?anycurl -X POST 'https://api.callmitra.ai/api/v1/agents/string/test-call' \ -H 'Content-Type: application/json' \ -d '{ "destination": "+919812345678", "phoneNumberId": "8a1d4c2e-0b7f-4e9a-9c3d-5f6e7a8b9c0d"}'{ "callId": "c2b7e0d4-1f3a-4b5c-8d9e-0a1b2c3d4e5f", "message": "Test call initiated", "phoneNumber": "+919812345678", "success": true}Start taking calls POST
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.
Update an agent PATCH
Saves the change as the agent's draft; calls keep using the published version until you call publishAgent. Only the `config` keys you send change; a nested object you send (for example `script`) replaces the stored one. Bad values are refused with `parameter_invalid` naming the field.