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

Transfer call

POST
/live/sessions/{session_id}/refer

Transfer a SIP call to another destination. Supply a nonblank target_uri for the SIP Refer-To header.

Path Parameters
session_id: string

Opaque Live session identifier from the creation response or incoming-call webhook. Preserve the returned value unchanged, including its prefix.

Body Parameters
JSON
target_uri: string

Nonblank URI for the SIP Refer-To header, such as tel:+14155550123 or sip:agent@example.com.

pattern\S
minLength1

Transfer call

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