> ## Documentation Index
> Fetch the complete documentation index at: https://plivo.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Voice

> Conferences, multiparty calls, recordings and SIP endpoints from the terminal.

Inspect conferences, manage group calls, retrieve recordings and configure SIP endpoints. Calls and live-call streams are on [Make and control calls](https://plivo.com/docs/cli/voice-agent/calls.md). After [logging in](https://plivo.com/docs/cli/install.md#log-in-with-a-browser), list active conferences:

```bash theme={null}
plivo voice conferences list
```

* Hangups, kicks, deletes and `stop-record` need `--yes`. Preview them with `--dry-run` alone. With `-o json`, every action on this page prints a result on stdout.
* Replace `<values>` with your own and omit `[flags]` unless adding options. TTS means text-to-speech.
* Paged lists take `--limit`, `--offset` and `--all`. Global flags: see [Configuration](https://plivo.com/docs/cli/configure.md).

## Conferences

Run `plivo voice conferences get "<conference_name>"` to find member IDs.

| Usage | What it does |
| - | - |
| `plivo voice conferences list` | List active conference names |
| `plivo voice conferences get <conference_name>` | Get conference details (members, run time) |
| `plivo voice conferences hangup <conference_name>` | End the entire conference (requires --yes) |
| `plivo voice conferences record <conference_name> [flags]` | Start recording a conference |
| `plivo voice conferences stop-record <conference_name> --yes` | Stop the active recording on a conference |
| `plivo voice conferences member deaf <conference_name> <member_id>` | Deafen a member (they can't hear) |
| `plivo voice conferences member undeaf <conference_name> <member_id>` | Undeafen a member |
| `plivo voice conferences member mute <conference_name> <member_id>` | Mute a member |
| `plivo voice conferences member unmute <conference_name> <member_id>` | Unmute a member |
| `plivo voice conferences member kick <conference_name> <member_id> --yes` | Remove the member from the conference. It doesn't hang up the member's call. |
| `plivo voice conferences member play <conference_name> <member_id> [flags]` | Play an audio file into a member's channel |
| `plivo voice conferences member stop-play <conference_name> <member_id>` | Stop audio playback to a member |
| `plivo voice conferences member speak <conference_name> <member_id> [flags]` | Speak TTS text to a member |
| `plivo voice conferences member stop-speak <conference_name> <member_id>` | Stop TTS playback to a member |

> [accordion] plivo voice conferences record
>
> | Flag | Description |
> | - | - |
> | `--callback-url <value>` | URL hit when recording finishes |
> | `--file-format <value>` | mp3\|wav (default "mp3") |
> | `--time-limit <integer>` | max recording length in seconds (default 60) |
> | `--transcription-type <value>` | transcription type: auto (results go to --transcription-url) |
> | `--transcription-url <value>` | URL the transcription is sent to |

> [accordion] plivo voice conferences member play
>
> | Flag | Description |
> | - | - |
> | `--url <value>` | URL of the .mp3 or .wav file to play (required) |

> [accordion] plivo voice conferences member speak
>
> | Flag | Description |
> | - | - |
> | `--language <value>` | language code such as `en-US` (BCP-47) (default "en-US") |
> | `--text <value>` | TTS text (required) |
> | `--voice <value>` | MAN\|WOMAN (default "WOMAN") |

## Multiparty calls

A multiparty call (MPC) is a group voice room. There is no create step: a room starts when you add its first participant. `participant add` dials out, spends money and requires `--yes`:

```bash theme={null}
plivo voice multiparty participant add support-room \
  --from +14155550100 --to +14155550101 --role customer --dry-run
```

Replace the numbers with your caller ID and test recipient, then swap `--dry-run` for `--yes` to dial. `participant list` shows participant IDs.

| Usage | What it does |
| - | - |
| `plivo voice multiparty list [flags]` | List multiparty calls |
| `plivo voice multiparty get <mpc_uuid_or_name>` | Get an MPC by uuid or friendly\_name |
| `plivo voice multiparty end <mpc_uuid_or_name>` | End the MPC and hang up all participants (requires --yes) |
| `plivo voice multiparty participant add <mpc_uuid_or_name> [flags]` | Add a participant by dialing out (spends money: requires --yes) |
| `plivo voice multiparty participant list <mpc_uuid_or_name>` | List all participants at once (no paging flags) |
| `plivo voice multiparty participant hold <mpc_uuid_or_name> <participant_id>` | Put a participant on hold |
| `plivo voice multiparty participant unhold <mpc_uuid_or_name> <participant_id>` | Take a participant off hold |
| `plivo voice multiparty participant mute <mpc_uuid_or_name> <participant_id>` | Mute a participant |
| `plivo voice multiparty participant unmute <mpc_uuid_or_name> <participant_id>` | Unmute a participant |
| `plivo voice multiparty participant kick <mpc_uuid_or_name> <participant_id>` | Remove a participant (requires --yes) |

> [accordion] plivo voice multiparty list
>
> | Flag | Description |
> | - | - |
> | `--status <value>` | filter by status: active\|initialized\|ended |

> [accordion] plivo voice multiparty participant add
>
> | Flag | Description |
> | - | - |
> | `--from <value>` | source number for the dial-out (required) |
> | `--role <value>` | participant role: agent\|supervisor\|customer (default "agent") |
> | `--to <value>` | destination number to add (required) |

## Recordings

List recordings (by call UUID, conference or time range), fetch one, or delete one.

```bash theme={null}
plivo voice recordings list --since 2026-10-01 --until 2026-10-07 -o json
```

* `list` filters on when a recording was added. Without `--since`, Plivo returns the last 7 days.
* `--since` and `--until` take UTC times as `YYYY-MM-DD` or `YYYY-MM-DD HH:MM[:SS]`. A bare `--until` date includes that day. `--until` needs `--since`. A range can cover at most 31 days.
* `--from-date` and `--to-date` are the same flags. The older `--from-time` and `--to-time` still work under the same rules but are deprecated.

| Usage | What it does |
| - | - |
| `plivo voice recordings list [flags]` | List recordings |
| `plivo voice recordings get <recording_id>` | Get a recording by ID |
| `plivo voice recordings delete <recording_id>` | Delete a recording (requires --yes) |

> [accordion] plivo voice recordings list
>
> | Flag | Description |
> | - | - |
> | `--call-uuid <value>` | filter by call uuid |
> | `--conference-name <value>` | filter by conference name |
> | `--since <value>` | recordings added at or after this UTC time (YYYY-MM-DD\[ HH:MM\[:SS]]), at most 31 days per request |
> | `--until <value>` | recordings added at or before this UTC time (YYYY-MM-DD\[ HH:MM\[:SS]]) |
> | `--from-date <value>` | same as --since |
> | `--to-date <value>` | same as --until |

## SIP endpoints

SIP endpoints are credentials that let a software phone or private branch exchange (PBX) register with Plivo. For platform trunks, use [SIP trunking](https://plivo.com/docs/cli/apis/sip.md). An endpoint's `password` reads `[REDACTED]` in every output format unless you add `--show-secrets`.

| Usage | What it does |
| - | - |
| `plivo voice endpoints create [flags]` | Create a SIP endpoint |
| `plivo voice endpoints list [flags]` | List SIP endpoints |
| `plivo voice endpoints get <endpoint_id>` | Get an endpoint by ID |
| `plivo voice endpoints update <endpoint_id> [flags]` | Update a SIP endpoint |
| `plivo voice endpoints delete <endpoint_id>` | Delete a SIP endpoint (requires --yes) |

> [accordion] plivo voice endpoints create
>
> | Flag | Description |
> | - | - |
> | `--alias <value>` | human-friendly label (required) |
> | `--app-id <value>` | application to attach |
> | `--password <value>` | SIP password (required) |
> | `--username <value>` | SIP username (required) |

> [accordion] plivo voice endpoints update
>
> | Flag | Description |
> | - | - |
> | `--alias <value>` | new alias |
> | `--app-id <value>` | new application id |
> | `--password <value>` | new password |