Schedule Calls

Schedule or immediately dispatch one or more outbound calls in a single request. Each entry is processed independently — some may be scheduled, others dispatched or failed.

Endpoint

Request Body

assistant_id
string
required
Assistant UUID to use for all calls
phone_number_id
string
required
Phone number UUID to call FROM
calls
array
required
Array of call entries. Each entry has:
  • phone_number (string, required) — destination in E.164 format
  • name (string, optional) — contact name for metadata
scheduled_at
string
ISO datetime for future dispatch. If omitted or in the past, calls are dispatched immediately.
initiate_via
string
Force a specific provider: krosai, twilio, or telnyx (optional)
metadata
object
Arbitrary key-value metadata attached to all calls (optional)

Example Request

Response

Each result status is one of dispatched, scheduled, or failed. Failed entries include an error field with the reason.

Errors