Calling | SignalWire

The CallingNamespace provides REST-based call control through the RestClient. All 37 commands are dispatched as POST requests to a single endpoint (/api/calling/calls) with a command field identifying the operation.

Access via client.calling on a RestClient instance.

Unlike the Relay client which uses persistent WebSocket connections, the Calling namespace sends each command as an independent HTTP request. This is suitable for server-side orchestration where you do not need real-time event streams.

Methods

Call Lifecycle

dial

Initiate a new outbound call via REST.

update

Update parameters on an active call via REST.

end

End an active call via REST.

Call Control

transfer

Transfer an active call to a new destination via REST.

disconnect

Disconnect (unbridge) a connected call without ending either leg via REST.

Media and Playback

play

Play audio or text-to-speech on an active call via REST.

play_pause

Pause an active playback on a call via REST.

play_resume

Resume a paused playback on a call via REST.

play_stop

Stop an active playback on a call via REST.

play_volume

Adjust the volume of an active playback on a call via REST.

Recording

record

Start recording an active call via REST.

record_pause

Pause an active recording on a call via REST.

record_resume

Resume a paused recording on a call via REST.

record_stop

Stop an active recording on a call via REST.

Input Collection

collect

Collect user input (DTMF or speech) on an active call via REST.

collect_stop

Stop an active input collection on a call via REST.

collect_start_input_timers

Manually start input timers for a collection on a call via REST.

Detection

detect

Start detection (answering machine, fax, DTMF) on a call via REST.

detect_stop

Stop an active detector on a call via REST.

Audio Tap

tap

Tap call audio to an external endpoint via REST.

tap_stop

Stop an active audio tap on a call via REST.

Audio Streaming

stream

Stream call audio to a WebSocket endpoint via REST.

stream_stop

Stop an active audio stream on a call via REST.

Noise Reduction

denoise

Enable noise reduction on an active call via REST.

denoise_stop

Disable noise reduction on an active call via REST.

Transcription and Translation

transcribe

Start transcribing speech on an active call via REST.

transcribe_stop

Stop an active transcription on a call via REST.

live_transcribe

Start live transcription with partial results on a call via REST.

live_translate

Start live translation on an active call via REST.

AI Session Control

ai_message

Send a message to an active AI session on a call via REST.

ai_hold

Put an active AI session on hold via REST.

ai_unhold

Resume a held AI session on a call via REST.

ai_stop

Stop an active AI session on a call via REST.

Fax

send_fax_stop

Stop an in-progress fax send operation on a call via REST.

receive_fax_stop

Stop an in-progress fax receive operation on a call via REST.

SIP

refer

Send a SIP REFER to transfer a call at the SIP level via REST.

Custom Events

user_event

Send custom user-defined events on an active call via REST.