Answer a call
Answer an incoming call. A 202 Accepted response
confirms only that the command was admitted; it does not confirm that the
call was answered. The session.answered webhook confirms completion. If
the call ends before it is answered, session.ended reports answered: false.
Only inbound phone sessions that are ringing or in early media can be answered. A new answer request in any other state returns 409 Conflict and creates no operation. Retrying an admitted request with the same Idempotency-Key replays its original response.
Triggered webhooks: session.answered
See Session lifecycle events for complete payload schemas and examples.
Authentication
Send Authorization: Bearer <app_uuid>:<api_key> using an active API key. See Authentication for details.
Path parameters
Session identifier.
Headers
Optional key for safely retrying mutating requests. An explicitly empty header is treated like omission and does not enable replay protection. See Idempotency for details.
optional client-supplied lowercase RFC-4122 v4 UUID returned as operation_uuid; platform generates one when omitted; correlation metadata distinct from Idempotency-Key.
Request
Response headers
Server-owned W3C Trace Context for correlating this response with support and observability data. It is present on successful and error responses. A valid incoming traceparent is linked to, but never becomes, the server-owned trace identifier.
Response
Optional. Set to true on idempotent terminal commands when the session was already in a terminal state at the time the request was received. Absent otherwise.