Skip to main content
POST
Start a human call transfer

Authorizations

Authorization
string
header
required

Use Authorization: Bearer pyai_live_... (or pyai_test_...).

Headers

Idempotency-Key
string
required

Path Parameters

id
string
required

Body

application/json
to
string
required

A new US/AU E.164 destination.

mode
enum<string>
required
Available options:
warm,
cold
user_id
string
required
Maximum string length: 200

Response

Durable transfer intent; status describes progress, not a promise of connection.

version
integer
project_id
string
direction
enum<string>
Available options:
inbound,
outbound
from
string
destination_number_id
string | null
admission_mode
enum<string> | null
Available options:
client,
platform,
null
admission_status
enum<string> | null
Available options:
pending,
accept,
reject,
expired,
null
admission_expires_at
integer | null

Original pre-answer admission deadline, Unix ms.

max_duration_seconds
integer | null
client_reference
string | null
agent_release_id
string | null
stop_requested
boolean
object
string
Example:

"telephony.call"

id
string
Example:

"tcall_..."

from_number_id
string | null
to
string
Example:

"+14155550123"

dialing_mode
string

Present for a parallel human-call group.

Allowed value: "parallel"
destinations
string[]
Required array length: 2 - 4 elements
connected_to
string | null

Destination confirmed by the group connection result; null while unresolved.

lines
object[]
agent_id
string | null
call_type
enum<string>
Available options:
human
user_id
string
transfer_enabled
boolean
transfers
object[]
use_case
enum<string>
Available options:
transactional,
support,
sales,
collections,
survey
routing_profile
enum<string>
Available options:
quality_first,
balanced,
cost_optimized
status
enum<string>
Available options:
queued,
dispatching,
ringing,
in_progress,
completed,
failed,
canceled,
dispatch_unknown
attempt_count
integer
Required range: 0 <= x <= 3
max_attempts
integer
Required range: 1 <= x <= 3
failure_reason
enum<string> | null
Available options:
network_unavailable,
congestion,
timeout,
no_answer,
busy,
rejected,
invalid_number,
identity_blocked,
compliance_blocked,
unknown,
null
created_at
integer

Unix ms.

updated_at
integer

Unix ms.

answered_at
integer | null

Unix ms.

ended_at
integer | null

Unix ms.

artifacts
object

Post-call artifact and billing readiness. Included on the single-call detail response; pending until the media edge finalizes the call.