Skip to content
Voice Agent CLI

Shells

The CLI receives JSON as one argument. Quote it for the current shell or use @path where the command advertises that syntax.

Bash and Zsh

Section titled “Bash and Zsh”
Terminal window
export RETELL_API_KEY=your_api_key
vac retell calls update call_123 \
  --metadata '{"case_id":"case_456"}'

Fish

Section titled “Fish”
Terminal window
set -x RETELL_API_KEY your_api_key
vac retell calls update call_123 \
  --metadata '{"case_id":"case_456"}'

PowerShell

Section titled “PowerShell”
Terminal window
$env:RETELL_API_KEY = "your_api_key"
vac retell calls update call_123 `
  --metadata '{"case_id":"case_456"}'

For larger payloads, keep JSON in a file:

Terminal window
vac retell calls update call_123 --metadata @metadata.json

Human-readable --help and --version output can go directly to the terminal. Normal provider data is JSON on stdout and structured failures are JSON on stderr.