POST/live/sessions/{session_id}/reject

Reject call

Reject an incoming SIP call. Send a required SIP rejection status_code between 300 and 699.

  • 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.
status_codeintegerrequired
SIP rejection status sent to the caller. This field is required.

5 status codes
200Session reject 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
500An internal error occurred. The response body is plain text.

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 500 is returned: An internal error occurred. The response body is plain text.