> Fetch clean Markdown by appending `.md` to any page URL under https://signalwire.com/docs or requesting it with the HTTP header `Accept: text/markdown`. The root index at https://signalwire.com/docs/llms.txt lists the available documentation indexes.

# Calling

> REST-based call control namespace with 37 commands for managing active calls.

[restclient]: /docs/server-sdks/reference/python/rest/client

[dial]: /docs/server-sdks/reference/python/rest/calling/dial

[update]: /docs/server-sdks/reference/python/rest/calling/update

[end]: /docs/server-sdks/reference/python/rest/calling/end

[transfer]: /docs/server-sdks/reference/python/rest/calling/transfer

[disconnect]: /docs/server-sdks/reference/python/rest/calling/disconnect

[play]: /docs/server-sdks/reference/python/rest/calling/play

[playpause]: /docs/server-sdks/reference/python/rest/calling/play-pause

[playresume]: /docs/server-sdks/reference/python/rest/calling/play-resume

[playstop]: /docs/server-sdks/reference/python/rest/calling/play-stop

[playvolume]: /docs/server-sdks/reference/python/rest/calling/play-volume

[record]: /docs/server-sdks/reference/python/rest/calling/record

[recordpause]: /docs/server-sdks/reference/python/rest/calling/record-pause

[recordresume]: /docs/server-sdks/reference/python/rest/calling/record-resume

[recordstop]: /docs/server-sdks/reference/python/rest/calling/record-stop

[collect]: /docs/server-sdks/reference/python/rest/calling/collect

[collectstop]: /docs/server-sdks/reference/python/rest/calling/collect-stop

[collectstartinputtimers]: /docs/server-sdks/reference/python/rest/calling/collect-start-input-timers

[detect]: /docs/server-sdks/reference/python/rest/calling/detect

[detectstop]: /docs/server-sdks/reference/python/rest/calling/detect-stop

[tap]: /docs/server-sdks/reference/python/rest/calling/tap

[tapstop]: /docs/server-sdks/reference/python/rest/calling/tap-stop

[stream]: /docs/server-sdks/reference/python/rest/calling/stream

[streamstop]: /docs/server-sdks/reference/python/rest/calling/stream-stop

[denoise]: /docs/server-sdks/reference/python/rest/calling/denoise

[denoisestop]: /docs/server-sdks/reference/python/rest/calling/denoise-stop

[transcribe]: /docs/server-sdks/reference/python/rest/calling/transcribe

[transcribestop]: /docs/server-sdks/reference/python/rest/calling/transcribe-stop

[livetranscribe]: /docs/server-sdks/reference/python/rest/calling/live-transcribe

[livetranslate]: /docs/server-sdks/reference/python/rest/calling/live-translate

[aimessage]: /docs/server-sdks/reference/python/rest/calling/ai-message

[aihold]: /docs/server-sdks/reference/python/rest/calling/ai-hold

[aiunhold]: /docs/server-sdks/reference/python/rest/calling/ai-unhold

[aistop]: /docs/server-sdks/reference/python/rest/calling/ai-stop

[sendfaxstop]: /docs/server-sdks/reference/python/rest/calling/send-fax-stop

[receivefaxstop]: /docs/server-sdks/reference/python/rest/calling/receive-fax-stop

[refer]: /docs/server-sdks/reference/python/rest/calling/refer

[userevent]: /docs/server-sdks/reference/python/rest/calling/user-event

The `CallingNamespace` provides REST-based call control through the
[`RestClient`][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`][restclient] instance.

> **Note**
>
> 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](/docs/server-sdks/reference/python/rest/calling/dial)

Initiate a new outbound call via REST.

#### [update](/docs/server-sdks/reference/python/rest/calling/update)

Update parameters on an active call via REST.

#### [end](/docs/server-sdks/reference/python/rest/calling/end)

End an active call via REST.

### Call Control

#### [transfer](/docs/server-sdks/reference/python/rest/calling/transfer)

Transfer an active call to a new destination via REST.

#### [disconnect](/docs/server-sdks/reference/python/rest/calling/disconnect)

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

### Media and Playback

#### [play](/docs/server-sdks/reference/python/rest/calling/play)

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

#### [play\_pause](/docs/server-sdks/reference/python/rest/calling/play-pause)

Pause an active playback on a call via REST.

#### [play\_resume](/docs/server-sdks/reference/python/rest/calling/play-resume)

Resume a paused playback on a call via REST.

#### [play\_stop](/docs/server-sdks/reference/python/rest/calling/play-stop)

Stop an active playback on a call via REST.

#### [play\_volume](/docs/server-sdks/reference/python/rest/calling/play-volume)

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

### Recording

#### [record](/docs/server-sdks/reference/python/rest/calling/record)

Start recording an active call via REST.

#### [record\_pause](/docs/server-sdks/reference/python/rest/calling/record-pause)

Pause an active recording on a call via REST.

#### [record\_resume](/docs/server-sdks/reference/python/rest/calling/record-resume)

Resume a paused recording on a call via REST.

#### [record\_stop](/docs/server-sdks/reference/python/rest/calling/record-stop)

Stop an active recording on a call via REST.

### Input Collection

#### [collect](/docs/server-sdks/reference/python/rest/calling/collect)

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

#### [collect\_stop](/docs/server-sdks/reference/python/rest/calling/collect-stop)

Stop an active input collection on a call via REST.

#### [collect\_start\_input\_timers](/docs/server-sdks/reference/python/rest/calling/collect-start-input-timers)

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

### Detection

#### [detect](/docs/server-sdks/reference/python/rest/calling/detect)

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

#### [detect\_stop](/docs/server-sdks/reference/python/rest/calling/detect-stop)

Stop an active detector on a call via REST.

### Audio Tap

#### [tap](/docs/server-sdks/reference/python/rest/calling/tap)

Tap call audio to an external endpoint via REST.

#### [tap\_stop](/docs/server-sdks/reference/python/rest/calling/tap-stop)

Stop an active audio tap on a call via REST.

### Audio Streaming

#### [stream](/docs/server-sdks/reference/python/rest/calling/stream)

Stream call audio to a WebSocket endpoint via REST.

#### [stream\_stop](/docs/server-sdks/reference/python/rest/calling/stream-stop)

Stop an active audio stream on a call via REST.

### Noise Reduction

#### [denoise](/docs/server-sdks/reference/python/rest/calling/denoise)

Enable noise reduction on an active call via REST.

#### [denoise\_stop](/docs/server-sdks/reference/python/rest/calling/denoise-stop)

Disable noise reduction on an active call via REST.

### Transcription and Translation

#### [transcribe](/docs/server-sdks/reference/python/rest/calling/transcribe)

Start transcribing speech on an active call via REST.

#### [transcribe\_stop](/docs/server-sdks/reference/python/rest/calling/transcribe-stop)

Stop an active transcription on a call via REST.

#### [live\_transcribe](/docs/server-sdks/reference/python/rest/calling/live-transcribe)

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

#### [live\_translate](/docs/server-sdks/reference/python/rest/calling/live-translate)

Start live translation on an active call via REST.

### AI Session Control

#### [ai\_message](/docs/server-sdks/reference/python/rest/calling/ai-message)

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

#### [ai\_hold](/docs/server-sdks/reference/python/rest/calling/ai-hold)

Put an active AI session on hold via REST.

#### [ai\_unhold](/docs/server-sdks/reference/python/rest/calling/ai-unhold)

Resume a held AI session on a call via REST.

#### [ai\_stop](/docs/server-sdks/reference/python/rest/calling/ai-stop)

Stop an active AI session on a call via REST.

### Fax

#### [send\_fax\_stop](/docs/server-sdks/reference/python/rest/calling/send-fax-stop)

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

#### [receive\_fax\_stop](/docs/server-sdks/reference/python/rest/calling/receive-fax-stop)

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

### SIP

#### [refer](/docs/server-sdks/reference/python/rest/calling/refer)

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

### Custom Events

#### [user\_event](/docs/server-sdks/reference/python/rest/calling/user-event)

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

> REST-based call control namespace with 37 commands for managing active calls.

## Docs

- [ai_hold](https://signalwire.com/docs/server-sdks/reference/python/rest/calling/ai-hold.md): Put an active AI session on hold via REST.
- [ai_message](https://signalwire.com/docs/server-sdks/reference/python/rest/calling/ai-message.md): Send a message to an active AI session on a call via REST.
- [ai_stop](https://signalwire.com/docs/server-sdks/reference/python/rest/calling/ai-stop.md): Stop an active AI session on a call via REST.
- [ai_unhold](https://signalwire.com/docs/server-sdks/reference/python/rest/calling/ai-unhold.md): Resume a held AI session on a call via REST.
- [collect](https://signalwire.com/docs/server-sdks/reference/python/rest/calling/collect.md): Collect user input (DTMF or speech) on an active call via REST.
- [collect_start_input_timers](https://signalwire.com/docs/server-sdks/reference/python/rest/calling/collect-start-input-timers.md): Manually start input timers for a collection on a call via REST.
- [collect_stop](https://signalwire.com/docs/server-sdks/reference/python/rest/calling/collect-stop.md): Stop an active input collection on a call via REST.
- [denoise](https://signalwire.com/docs/server-sdks/reference/python/rest/calling/denoise.md): Enable noise reduction on an active call via REST.
- [denoise_stop](https://signalwire.com/docs/server-sdks/reference/python/rest/calling/denoise-stop.md): Disable noise reduction on an active call via REST.
- [detect](https://signalwire.com/docs/server-sdks/reference/python/rest/calling/detect.md): Start detection (answering machine, fax, DTMF) on a call via REST.
- [detect_stop](https://signalwire.com/docs/server-sdks/reference/python/rest/calling/detect-stop.md): Stop an active detector on a call via REST.
- [dial](https://signalwire.com/docs/server-sdks/reference/python/rest/calling/dial.md): Initiate a new outbound call via REST.
- [disconnect](https://signalwire.com/docs/server-sdks/reference/python/rest/calling/disconnect.md): Disconnect (unbridge) a connected call without ending either leg via REST.
- [end](https://signalwire.com/docs/server-sdks/reference/python/rest/calling/end.md): End an active call via REST.
- [live_transcribe](https://signalwire.com/docs/server-sdks/reference/python/rest/calling/live-transcribe.md): Start live transcription with partial results on a call via REST.
- [live_translate](https://signalwire.com/docs/server-sdks/reference/python/rest/calling/live-translate.md): Start live translation on an active call via REST.
- [play](https://signalwire.com/docs/server-sdks/reference/python/rest/calling/play.md): Play audio or text-to-speech on an active call via REST.
- [play_pause](https://signalwire.com/docs/server-sdks/reference/python/rest/calling/play-pause.md): Pause an active playback on a call via REST.
- [play_resume](https://signalwire.com/docs/server-sdks/reference/python/rest/calling/play-resume.md): Resume a paused playback on a call via REST.
- [play_stop](https://signalwire.com/docs/server-sdks/reference/python/rest/calling/play-stop.md): Stop an active playback on a call via REST.
- [play_volume](https://signalwire.com/docs/server-sdks/reference/python/rest/calling/play-volume.md): Adjust the volume of an active playback on a call via REST.
- [receive_fax_stop](https://signalwire.com/docs/server-sdks/reference/python/rest/calling/receive-fax-stop.md): Stop an in-progress fax receive operation on a call via REST.
- [record](https://signalwire.com/docs/server-sdks/reference/python/rest/calling/record.md): Start recording an active call via REST.
- [record_pause](https://signalwire.com/docs/server-sdks/reference/python/rest/calling/record-pause.md): Pause an active recording on a call via REST.
- [record_resume](https://signalwire.com/docs/server-sdks/reference/python/rest/calling/record-resume.md): Resume a paused recording on a call via REST.
- [record_stop](https://signalwire.com/docs/server-sdks/reference/python/rest/calling/record-stop.md): Stop an active recording on a call via REST.
- [refer](https://signalwire.com/docs/server-sdks/reference/python/rest/calling/refer.md): Send a SIP REFER to transfer a call at the SIP level via REST.
- [send_fax_stop](https://signalwire.com/docs/server-sdks/reference/python/rest/calling/send-fax-stop.md): Stop an in-progress fax send operation on a call via REST.
- [stream](https://signalwire.com/docs/server-sdks/reference/python/rest/calling/stream.md): Stream call audio to a WebSocket endpoint via REST.
- [stream_stop](https://signalwire.com/docs/server-sdks/reference/python/rest/calling/stream-stop.md): Stop an active audio stream on a call via REST.
- [tap](https://signalwire.com/docs/server-sdks/reference/python/rest/calling/tap.md): Tap call audio to an external endpoint via REST.
- [tap_stop](https://signalwire.com/docs/server-sdks/reference/python/rest/calling/tap-stop.md): Stop an active audio tap on a call via REST.
- [transcribe](https://signalwire.com/docs/server-sdks/reference/python/rest/calling/transcribe.md): Start transcribing speech on an active call via REST.
- [transcribe_stop](https://signalwire.com/docs/server-sdks/reference/python/rest/calling/transcribe-stop.md): Stop an active transcription on a call via REST.
- [transfer](https://signalwire.com/docs/server-sdks/reference/python/rest/calling/transfer.md): Transfer an active call to a new destination via REST.
- [update](https://signalwire.com/docs/server-sdks/reference/python/rest/calling/update.md): Update parameters on an active call via REST.
- [user_event](https://signalwire.com/docs/server-sdks/reference/python/rest/calling/user-event.md): Send custom user-defined events on an active call via REST.