OpenAI API (unofficial showcase)
POST/realtime/calls/{call_id}/refer

Refer call

Transfer an active SIP call to a new destination using the SIP REFER verb.

  • 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.

Destination URI for the REFER request.

target_uristringrequired
URI that should appear in the SIP Refer-To header. Supports values like `tel:+14155550123` or `sip:agent@example.com`.

3 status codes
200Call referred successfully.
404The session or call was not found or is unavailable for 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 500 is returned: An internal error occurred. The response body is plain text.