Skip to main content
POST
Decide a pending inbound admission

Authorizations

Authorization
string
header
required

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

Path Parameters

id
string
required

Body

application/json
decision
enum<string>
required
Available options:
accept,
reject
client_reference
string
required
Required string length: 1 - 200
max_duration_seconds
integer
required
Required range: 30 <= x <= 600

Response

Saved call decision

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"

agent_id
string | null
call_type
enum<string>
Available options:
human
user_id
string
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.