Calling Commands

The webex calling subcommand provides access to the Webex Calling API. No --orgid is needed — the organization is inferred from your authentication token.

Resource Groups

Resource	Description
announcement-playlist	Announcement playlist management
announcement-repository	Announcement repository management
auto-attendant	Auto attendant / IVR configuration
call-controls	Active call control operations
call-park	Call park settings
call-pickup	Call pickup groups
call-queue	Call queue configuration
call-recording	Call recording settings
call-routing	Call routing configuration
call-settings-for-me	Personal call settings
caller-reputation-provider	Caller reputation / spam management
calling-service	Calling service configuration
client-call	Client call management
conference-controls	Conference call controls
converged-recordings	Recording access and management
customer-experience-essentials	Customer experience essentials
dect-devices	DECT handset and base station management
device-call	Per-device call settings
devices	Device provisioning and management
emergency-services	E911 and emergency callback
external-voicemail	External voicemail settings
hot-desk	Hot desk configuration
hot-desking-sign-in-via-voice-portal	Hot desking voice portal sign-in
hunt-group	Hunt group configuration
location-call	Per-location call settings
location-call-handling	Location call handling rules
location-schedules	Location schedule management
location-voicemail	Location voicemail settings
locations	Location management
numbers	Phone number inventory
operating-modes	Operating mode schedules
paging-group	Paging group configuration
partner-reports-templates	Partner report templates
people	Users and their calling settings
pstn	PSTN connection and trunk settings
recording-report	Recording reports
reports	CDR and call history reports
reports-detailed-call-history	Detailed call history reports
send-activation-email	Send activation emails
single-number-reach	Single number reach / simultaneous ring
user-call	Per-user call settings
virtual-extensions	Virtual extension configuration
virtual-line-call	Virtual line call settings
workspace-call	Per-workspace call settings
workspaces	Workspace management

Common Patterns

# List resources
webex calling <resource> list

# Get by ID
webex calling <resource> get --id "..."

# Create
webex calling <resource> create --body-file config.json

# Update
webex calling <resource> update --id "..." --body-file updated.json

# Delete
webex calling <resource> delete --id "..."

Examples

# List all people
webex calling people list --paginate

# Get your own details
webex calling people get-my-own

# List locations
webex calling locations list

# Get call settings for a person
webex calling user-call get-voicemail --person-id "PERSON_ID"

# List call queues at a location
webex calling call-queue list --location-id "LOCATION_ID"

# Get detailed call history
webex calling reports-detailed-call-history list --start-time "2024-01-01T00:00:00Z"

# List devices
webex calling devices list --paginate

Converged Recording Downloads

The converged-recordings download command downloads Webex Calling call recordings to a local file. It fetches recording metadata (which includes temporaryDirectDownloadLinks), then downloads the binary.

# Download audio (MP3) — default
webex calling converged-recordings download --recording-id <id> --output call.mp3

# Download full recording
webex calling converged-recordings download --recording-id <id> --output call.mp4 --type recording

# Download transcript
webex calling converged-recordings download --recording-id <id> --output call.vtt --type transcript

Note: To list converged recordings as an admin, use the admin endpoint:

# Admin/compliance officer listing (max 30-day range)
webex calling converged-recordings list-admin-compliance-officer --last 720h

# User's own recordings
webex calling converged-recordings list --last 720h

The non-admin list endpoint (GET /convergedRecordings) requires the caller to be the recording owner. The admin endpoint (GET /admin/convergedRecordings) returns recordings across the org and requires spark-admin:recordings_read.

Announcement Uploads

Upload announcement greetings at the organization or location level. These replace the generated commands which could not handle multipart/form-data file uploads.

# Upload org-level announcement
webex calling announcement-repository upload-binary-greeting --file greeting.wav --name "Main Greeting"

# Upload location-level announcement
webex calling announcement-repository upload-binary-greeting-2 --file greeting.wav --name "Lobby" --location-id <id>

# Update existing announcement
webex calling announcement-repository update-binary-greeting --file updated.wav --name "Updated" --announcement-id <id>

# Update location-level announcement
webex calling announcement-repository update-binary-greeting-2 --file updated.wav --name "Updated" --location-id <id> --announcement-id <id>

Voicemail & Intercept Greeting Uploads

Upload voicemail and call intercept greetings for people, virtual lines, workspaces, or yourself. All commands accept --file (WAV, max 5MB) and support --dry-run.

# Person greetings
webex calling user-call update-busy-voicemail-greeting-person --person-id <id> --file greeting.wav
webex calling user-call update-no-answer-voicemail-greeting-person --person-id <id> --file greeting.wav
webex calling user-call update-intercept-greeting-person --person-id <id> --file greeting.wav

# Your own greetings
webex calling call-settings-for-me upload-voicemail-busy-greeting --file greeting.wav
webex calling call-settings-for-me upload-voicemail-no-answer-greeting --file greeting.wav

# Virtual line greetings
webex calling virtual-line-call update-busy-voicemail-greeting --virtual-line-id <id> --file greeting.wav
webex calling virtual-line-call update-no-answer-voicemail-greeting --virtual-line-id <id> --file greeting.wav
webex calling virtual-line-call update-intercept-greeting --virtual-line-id <id> --file greeting.wav

# Workspace greetings
webex calling workspace-call update-busy-voicemail-greeting-place --workspace-id <id> --file greeting.wav
webex calling workspace-call update-no-answer-voicemail-greeting-place --workspace-id <id> --file greeting.wav
webex calling workspace-call upload-intercept-announcement-file --workspace-id <id> --file greeting.wav