place an outbound call
dial toNumber and connect whoever answers to the agent — the dashboard’s test on phone. the bot is started and the greeting synthesised while the phone rings, so the callee hears it the moment they pick up. billed, recorded and listed exactly like a web call, with channel: "phone".
caller id. fromTrunkId dials from one of your SIP trunks. fromNumber names a number you own: a SIP trunk’s, or a rented number that is active and already connected to this agent. with neither, the call dials from the agent’s connected rented number if it has one, else from the platform’s shared number.
the agent must be deployed and use a voice that can take calls (muga or mulberry, see GET /v1/voices); a draft answers 409 agent_not_deployed, so a call never runs a configuration you did not release. answers 202 once the carrier accepts the dial; follow the call with GET /v1/calls/{call_id}.
Authorizations
your rumik api key, e.g. rk_live_.... create one in the rumik dashboard.
Body
the body of POST /v1/calls.
the agent to run — its UUID or its ua_… handle. it must be deployed and use a voice that can take calls.
1 - 64the number to dial, in E.164 (+ and 7–15 digits; spaces tolerated).
the caller id, as one of your numbers: a SIP trunk's number, or a rented number that is active and connected to this agent. omit to use the agent's connected rented number, or the platform's number.
dial from this SIP trunk (its id). wins over fromNumber.
call behaviour for this one call. omit to use the agent's stored settings.
Response
accepted — the call is being placed.
Ack that the call is being placed. callId is the run id — the row
GET /v1/calls/{id} and the dashboard's conversations show.
the call's id. what GET /v1/calls/{call_id} and the dashboard's conversations show; store it to correlate the call with your own records.
always calling: the dial was accepted. follow the call by id.
the agent's UUID.
the number dialed, normalised to E.164.
the caller id the callee sees; null when the platform's shared number was used.