For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Log inSign up
Support
GuidesReference
GuidesReference
    • Core
      • Overview
    • Agents
      • Overview
      • AgentBase
      • AgentServer
      • Configuration
      • ContextBuilder
      • DataMap
      • FunctionResult
      • Helper Functions & Utilities
      • LiveWire
      • PomBuilder
      • Prefabs
      • SkillBase
      • SkillManager
      • SkillRegistry
      • Skills
      • SwaigFunction
      • SwmlBuilder
      • SWMLService
    • RELAY
      • Overview
      • Actions
      • Call
      • Constants
      • Events
      • Message
      • RelayClient
      • RelayError
    • REST Client
      • Overview
      • Addresses
      • Calling
        • aiHold
        • aiMessage
        • aiStop
        • aiUnhold
        • collect
        • collectStartInputTimers
        • collectStop
        • denoise
        • denoiseStop
        • detect
        • detectStop
        • dial
        • disconnect
        • end
        • liveTranscribe
        • liveTranslate
        • play
        • playPause
        • playResume
        • playStop
        • playVolume
        • receiveFaxStop
        • record
        • recordPause
        • recordResume
        • recordStop
        • refer
        • sendFaxStop
        • stream
        • streamStop
        • tap
        • tapStop
        • transcribe
        • transcribeStop
        • transfer
        • update
        • userEvent
      • ChatResource
      • Compat
      • Datasphere
      • Fabric
      • ImportedNumbersResource
      • Logs
      • LookupResource
      • MFA
      • Number Groups
      • Phone Numbers
      • Project
      • PubSubResource
      • Queues
      • Recordings
      • Registry
      • RestClient
      • RestError
      • Short Codes
      • SIP Profile
      • Verified Callers
      • Video
LogoLogoSignalWire Docs
Log inSign up
Support
On this page
  • Methods
  • Call Lifecycle
  • Call Control
  • Media and Playback
  • Recording
  • Input Collection
  • Detection
  • Audio Tap
  • Audio Streaming
  • Noise Reduction
  • Transcription and Translation
  • AI Session Control
  • Fax
  • SIP
  • Custom Events
REST Client

Calling

|View as Markdown|Open in Claude|
Was this page helpful?
Edit this page
Previous

aiHold

Next
Built with

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.

playPause

Pause an active playback on a call via REST.

playResume

Resume a paused playback on a call via REST.

playStop

Stop an active playback on a call via REST.

playVolume

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

Recording

record

Start recording an active call via REST.

recordPause

Pause an active recording on a call via REST.

recordResume

Resume a paused recording on a call via REST.

recordStop

Stop an active recording on a call via REST.

Input Collection

collect

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

collectStop

Stop an active input collection on a call via REST.

collectStartInputTimers

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.

detectStop

Stop an active detector on a call via REST.

Audio Tap

tap

Tap call audio to an external endpoint via REST.

tapStop

Stop an active audio tap on a call via REST.

Audio Streaming

stream

Stream call audio to a WebSocket endpoint via REST.

streamStop

Stop an active audio stream on a call via REST.

Noise Reduction

denoise

Enable noise reduction on an active call via REST.

denoiseStop

Disable noise reduction on an active call via REST.

Transcription and Translation

transcribe

Start transcribing speech on an active call via REST.

transcribeStop

Stop an active transcription on a call via REST.

liveTranscribe

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

liveTranslate

Start live translation on an active call via REST.

AI Session Control

aiMessage

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

aiHold

Put an active AI session on hold via REST.

aiUnhold

Resume a held AI session on a call via REST.

aiStop

Stop an active AI session on a call via REST.

Fax

sendFaxStop

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

receiveFaxStop

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

userEvent

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