resources/realtime/subresources/calls/methods/refer/index.md 2026-07-10 23:02 UTC to 2026-07-12 06:58 UTC

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

Body Parameters

• target_uri: string

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

Example

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

Example

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"}'