POST/realtime/calls/{call_id}/reject

Reject call

Decline an incoming SIP call by returning a SIP status code to the caller.

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

1 parameter · 1 body field
call_idstringrequired
The identifier for the call provided in the [`realtime.call.incoming`](https://developers.openai.com/api/reference/resources/webhooks#realtime.call.incoming) webhook.

Provide an optional SIP status code. When omitted the API responds with 603 Decline.

status_codeintegeroptional
SIP response code to send back to the caller. Defaults to `603` (Decline) when omitted.

4 status codes
200Call rejected successfully.
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 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.