Categorized Overview

5 min

Introduction

Leg Actions are executed on an active call leg to control media, call state, routing, recording, and real-time integrations.

Use this page to quickly discover the right action before diving into detailed API reference pages.

These actions control what the participant hears, says, or inputs during a call.

<Say> Converts text to speech and plays it to the leg. Supports Amazon Polly and Google TTS.

<PlaySequence> Plays a sequence of media actions (e.g., Play → Say → Play) in order.

<SendDigits> Plays DTMF tones out to the leg (used to interact with downstream IVRs).

These actions manage the lifecycle and audio state of a call leg.

<Mute> / <UnMute> Mutes or unmutes audio on the leg. Supports direction control: in, out, or both.

<Hold> / <UnHold> Places the leg on hold and resumes it. Supports optional Music on Hold (MOH) using nested <StartPlay>.

Advanced actions for connecting legs, conferencing, and supervision.

<Dial> Creates a new outbound leg and bridges it to the current leg. Supports PSTN and VoIP destinations.

<StartMonitoring> Allows a supervisor to listen or whisper on another leg (rxAudio: muted / enabled).

These actions manage call recordings at the leg level.

<StartRecording> Starts recording audio on the leg. Supports multiple formats and storage options (S3 / HTTPS).

Used for voice bots, real-time analytics, and AI processing.

<StartStream> Streams live audio from the leg to a WebSocket endpoint.Supports unidirectional and bidirectional streaming.

Actions that affect control ownership and event delivery.

<Refer> Updates the external event delivery endpoint (gRPC) for the leg.Used when control needs to be transferred between systems.

Category	Actions
Media & Interaction	StartPlay, StopPlay, Say, StopSay, PlaySequence, Gather, SendDigits
Call State Control	Answer, Hangup, Mute, UnMute, Hold, UnHold
Connectivity & Routing	Dial, JoinBridge, LeaveBridge, StartMonitoring, StopMonitoring
Recording	StartRecording, StopRecording
Streaming	StartStream, StopStream
Control & Event Routing	Refer