POST/live/sessions/{session_id}/accept

Accept call

Accept an incoming SIP call. Supply session with type live, the model, and startup configuration. Before accepting calls, follow the Live prompting guide to write frontend conversation instructions and a separate backend prompt. SIP media format is negotiated; omit audio.format.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

1 parameter · 1 body field
session_idstringrequired
Opaque Live session identifier from the creation response or incoming-call webhook. Preserve the returned value unchanged, including its prefix.
sessionobjectrequired
Model and startup configuration for the Live session that answers the incoming SIP call.

7 status codes
200Session accept request accepted.
400Invalid request body or headers.
errorobjectrequired
404The session or call was not found or is unavailable for this operation.
errorobjectrequired
409The session or call can no longer accept this operation.
errorobjectrequired
429The session could not start because a rate or quota limit was exceeded.
errorobjectrequired
500An internal error occurred. The response body is plain text.
503The session is temporarily unavailable.
errorobjectrequired

Error handling

A 400 is returned: Invalid request body or headers. A 404 is returned: The session or call was not found or is unavailable for this operation. A 409 is returned: The session or call can no longer accept this operation. A 429 is returned: The session could not start because a rate or quota limit was exceeded. A 500 is returned: An internal error occurred. The response body is plain text. A 503 is returned: The session is temporarily unavailable.