refer | SignalWire

Send a SIP REFER on an active call. This initiates a SIP-level transfer, asking the remote endpoint to connect to a new destination. Unlike transfer(), which is handled by SignalWire, a SIP REFER delegates the transfer to the remote SIP endpoint.

SIP REFER is only applicable to SIP calls. It will not work on PSTN calls.

Request

dialobjectRequired

updateobjectRequired

calling.endobjectRequired

calling.disconnectobjectRequired

calling.ai_holdobjectRequired

calling.ai_unholdobjectRequired

calling.ai_messageobjectRequired

calling.ai.stopobjectRequired

calling.playobjectRequired

calling.play.pauseobjectRequired

calling.play.resumeobjectRequired

calling.play.stopobjectRequired

calling.play.volumeobjectRequired

calling.recordobjectRequired

calling.record.pauseobjectRequired

calling.record.resumeobjectRequired

calling.record.stopobjectRequired

calling.collectobjectRequired

calling.collect.stopobjectRequired

calling.collect.start_input_timersobjectRequired

calling.detectobjectRequired

calling.detect.stopobjectRequired

calling.tapobjectRequired

calling.tap.stopobjectRequired

calling.streamobjectRequired

calling.stream.stopobjectRequired

calling.denoiseobjectRequired

calling.denoise.stopobjectRequired

calling.transcribeobjectRequired

calling.transcribe.stopobjectRequired

calling.live_transcribeobjectRequired

calling.live_translateobjectRequired

calling.transferobjectRequired

calling.send_fax.stopobjectRequired

calling.receive_fax.stopobjectRequired

calling.referobjectRequired

calling.user_eventobjectRequired

Response

Call LegobjectRequired

Fabric Subscriber Device LegobjectRequired

Response Example

Response

1 {
2   "id": "0e9c80d7-a149-4917-892d-420043709f45",
3   "from": "+12069708643",
4   "to": "+15550198765",
5   "direction": "outbound-api",
6   "source": "realtime_api",
7   "charge": 0,
8   "created_at": "2024-05-06T12:20:00Z",
9   "charge_details": [
10     {
11       "description": "Outbound Voice",
12       "charge": 0.004
13     }
14   ],
15   "status": "queued",
16   "type": "relay_pstn_call"
17 }

Example

1 from signalwire.rest import RestClient
2 
3 client = RestClient(
4     project="your-project-id",
5     token="your-api-token",
6     host="your-space.signalwire.com",
7 )
8 
9 client.calling.refer(
10     call_id="call-id-xxx",
11     device={"type": "sip", "params": {"to": "sip:sales@example.com"}},
12 )