Arm a takeover
Arms a takeover on a call in progress; the person dials in. Every field is optional: with an empty body it is a dial_in takeover for the agent’s handoff.number with a 60-second window. To have Mirai ring someone instead, see Ring a colleague into the call.
connect:{"type": "dial_in", "to": "+91…"}.typedefaults todial_in.towins over the agent’s number; it can’t be the call’s own number or the caller’s.ttl_secs: 15 to 180, default 60.instruction: given to the agent as a live instruction, e.g. ask the caller to hold.metadata: your own fields, up to 2 KB, echoed.modetalk,aipaused,after_humanend_call: the only values today.
It waits up to 3 seconds for the call to confirm. 201 means the person can dial connect.dial now. One takeover at a time per call (409 handoff_in_progress), up to 5 per call. A takeover that never connects costs nothing.
Send an Idempotency-Key: a repeat returns the same takeover and arms nothing new.
Authorizations
Headers
Body
Response
Armed: dial connect.dial now
A live human takeover of a call in progress (a phone call, or a web call rung out to the person).