Start an outbound agent call
Start an outbound call from one of your active managed numbers into an Omni agent. A valid Idempotency-Key is mandatory. The platform never retries an ambiguous carrier dispatch and never changes routes after answer; only a confirmed retryable pre-answer result may advance an already-approved route plan. Limited availability: returns 404 until outbound telephony is enabled for the deployment. Requires telephony:manage.
Authorizations
Use Authorization: Bearer pyai_live_... (or pyai_test_...).
Headers
Required safe-retry key. Identical retries return the original call; a different body returns 409.
255Body
Active managed-number ID to present as caller ID.
Supported E.164 destination.
"+14155550123"
Omni agent that handles the connected call.
Declared calling purpose. Determines consent, identity, CNAM, and policy gates.
transactional, support, sales, collections, survey quality_first, balanced, cost_optimized Response
Call accepted
"telephony.call"
"tcall_..."
"+14155550123"
transactional, support, sales, collections, survey quality_first, balanced, cost_optimized queued, dispatching, ringing, in_progress, completed, failed, canceled, dispatch_unknown 0 <= x <= 31 <= x <= 3carrier_unavailable, congestion, timeout, no_answer, busy, rejected, invalid_number, identity_blocked, compliance_blocked, unknown, null Unix ms.
Unix ms.
Unix ms.
Unix ms.