Initiate Call
Start an outbound call from an assistant to a phone number. Supports both immediate dispatch and future scheduling.Endpoint
Request Body
Assistant UUID
Destination phone number (E.164 format)
Phone number UUID to call from (optional, inferred if omitted)
ISO datetime to schedule the call for. If omitted or in the past, the call is dispatched immediately.
Force a specific provider:
krosai, twilio, or telnyx (optional)Arbitrary key-value metadata to attach (optional)
Example Request
Response
"status": "scheduled" with no session_id:
Errors
See also
- Initiate Call vs Meet — when to use telephony vs realtime web sessions
- Meet Sessions — start a realtime web session instead of a phone call

