Skip to content
Primary navigation

Suggested
API Dashboard
API Reference
Realtime
Calls

Refer call

client.realtime.calls.refer(stringcallID, CallReferParams { target_uri } body, RequestOptionsoptions?): void
POST/realtime/calls/{call_id}/refer

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

ParametersExpand Collapse
callID: string
body: CallReferParams { target_uri }
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

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: process.env['OPENAI_API_KEY'], // This is the default and can be omitted
});

await client.realtime.calls.refer('call_id', { target_uri: 'tel:+14155550123' });
Returns Examples