Skip to content
For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
Primary navigation
Theme

Suggested
Overview Models Agents Tools Audio & voice Production API reference

Refer call

POST
/realtime/calls/{call_id}/refer

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

Path Parameters
call_id: string

The identifier for the call provided in the realtime.call.incoming webhook.

Body Parameters
JSON
target_uri: string

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

Refer call

curl -X POST https://api.openai.com/v1/realtime/calls/$CALL_ID/refer \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"target_uri": "tel:+14155550123"}'
Returns Examples