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

# Command Reference

> Comprehensive reference for every Telnyx CLI command, auto-generated from the Telnyx REST API with options, examples, and per-resource usage notes.

This page provides a comprehensive reference for all available CLI commands. Use `telnyx <command> --help` for detailed options.

<Note>
  The CLI is auto-generated from the [Telnyx REST API](/api-reference/overview). For full request/response schemas, see the corresponding API reference for each resource.
</Note>

## Global Options

These flags work with all commands:

```bash theme={null}
--debug                   # Enable debug logging (shows HTTP requests/responses)
--base-url <url>          # Override the API base URL
--format <format>         # Output format: auto, json, jsonl, pretty, yaml, raw
--format-error <format>   # Error output format
--transform <gjson>       # Transform output using GJSON syntax
--help, -h                # Show help
--version, -v             # Show version
```

## Phone Numbers

<Note>
  See [Phone Numbers API](/api-reference/numbers/list-phone-numbers) for full response schemas.
</Note>

### List & Manage Numbers

```bash theme={null}
# List your phone numbers
telnyx phone-numbers list
telnyx phone-numbers list --filter.status active
telnyx phone-numbers list --page-size 50

# Get number details
telnyx phone-numbers retrieve --id <phone-number-id>

# Update number settings
telnyx phone-numbers update --id <phone-number-id> --connection-id <id>

# Delete a number
telnyx phone-numbers delete --id <phone-number-id>
```

### Search Available Numbers

```bash theme={null}
# Search available numbers
telnyx available-phone-numbers list --filter.country-code US
telnyx available-phone-numbers list --filter.country-code US --filter.limit 10
telnyx available-phone-numbers list --filter.country-code US --filter.locality "San Francisco"

# Search number blocks
telnyx available-phone-number-blocks list --filter.country-code US
```

### Purchase Numbers

```bash theme={null}
# Create a number order
telnyx number-orders create --phone-number +15551234567
telnyx number-orders create --phone-number +15551234567 --messaging-profile-id <id>

# List/retrieve orders
telnyx number-orders list
telnyx number-orders retrieve --id <order-id>
```

### Number Reservations

```bash theme={null}
telnyx number-reservations create --phone-numbers +15551234567
telnyx number-reservations list
telnyx number-reservations retrieve --id <reservation-id>
telnyx number-reservations delete --id <reservation-id>
```

## Messaging

<Note>
  See [Messaging API](/api-reference/messages/send-message) for full payload options.
</Note>

### Send Messages

```bash theme={null}
# Send SMS
telnyx messages send --from +15551234567 --to +15559876543 --text "Hello!"

# Send MMS
telnyx messages send --from +15551234567 --to +15559876543 \
  --text "Check this out" \
  --media-url https://example.com/image.jpg

# Send WhatsApp message
telnyx messages send-whatsapp --from +15551234567 --to +15559876543 --text "Hello!"

# Schedule a message
telnyx messages schedule --from +15551234567 --to +15559876543 \
  --text "Reminder!" --send-at "2024-12-01T10:00:00Z"

# Cancel scheduled message
telnyx messages cancel-scheduled --id <message-id>
```

### Retrieve Messages

```bash theme={null}
telnyx messages retrieve --id <message-id>
```

### Messaging Profiles

```bash theme={null}
telnyx messaging-profiles list
telnyx messaging-profiles retrieve --id <profile-id>
telnyx messaging-profiles create --name "Production"
telnyx messaging-profiles update --id <profile-id> --name "Updated Name"
telnyx messaging-profiles delete --id <profile-id>

# List associated phone numbers
telnyx messaging-profiles list-phone-numbers --messaging-profile-id <id>
```

### Optouts

```bash theme={null}
telnyx messaging-optouts list
```

## 10DLC (US A2P Messaging)

<Note>
  See [10DLC documentation](/docs/messaging/10dlc/quickstart) for registration requirements.
</Note>

### Brands

```bash theme={null}
# List brands
telnyx messaging-10dlc:brand list

# Create brand
telnyx messaging-10dlc:brand create \
  --entity-type PRIVATE_PROFIT \
  --display-name "My Company" \
  --company-name "My Company Inc" \
  --ein 12-3456789 \
  --phone +15551234567 \
  --street "123 Main St" \
  --city "San Francisco" \
  --state CA \
  --postal-code 94102 \
  --country US \
  --vertical TECHNOLOGY \
  --website https://example.com

# Retrieve/update brand
telnyx messaging-10dlc:brand retrieve --brand-id <id>
telnyx messaging-10dlc:brand update --brand-id <id> --display-name "New Name"

# Revet brand (resubmit for verification)
telnyx messaging-10dlc:brand revet --brand-id <id>

# SMS OTP verification for sole proprietor
telnyx messaging-10dlc:brand trigger-sms-otp --brand-id <id>
telnyx messaging-10dlc:brand verify-sms-otp --brand-id <id> --otp 123456

# Get brand feedback
telnyx messaging-10dlc:brand get-feedback --brand-id <id>

# Delete brand
telnyx messaging-10dlc:brand delete --brand-id <id>
```

### Campaigns

```bash theme={null}
# List campaigns
telnyx messaging-10dlc:campaign list --brand-id <id>

# Retrieve campaign
telnyx messaging-10dlc:campaign retrieve --campaign-id <id>

# Update campaign (only sample messages editable)
telnyx messaging-10dlc:campaign update --campaign-id <id> --sample-messages "New sample"

# Get campaign operation status
telnyx messaging-10dlc:campaign get-operation-status --campaign-id <id>

# Deactivate campaign
telnyx messaging-10dlc:campaign deactivate --campaign-id <id>

# Submit appeal for rejected campaign
telnyx messaging-10dlc:campaign submit-appeal --campaign-id <id>
```

### Use Cases

```bash theme={null}
telnyx messaging-10dlc:campaign:usecase list
```

### Phone Number Campaigns

```bash theme={null}
telnyx messaging-10dlc:phone-number-campaigns list
telnyx messaging-10dlc:phone-number-campaigns retrieve --phone-number +15551234567
```

## Voice / Call Control

<Note>
  See [Call Control API](/api-reference/call-control) for advanced call flow options.
</Note>

### Make Calls

```bash theme={null}
# Dial outbound call
telnyx calls dial \
  --connection-id <id> \
  --from +15551234567 \
  --to +15559876543

# With answering machine detection
telnyx calls dial \
  --connection-id <id> \
  --from +15551234567 \
  --to +15559876543 \
  --answering-machine-detection detect
```

### Call Status

```bash theme={null}
telnyx calls retrieve-status --call-control-id <id>
```

### Call Actions

```bash theme={null}
# Answer incoming call
telnyx calls:actions answer --call-control-id <id>

# Hang up
telnyx calls:actions hangup --call-control-id <id>

# Transfer call
telnyx calls:actions transfer --call-control-id <id> --to +15559876543

# Bridge two calls
telnyx calls:actions bridge --call-control-id <id> --call-control-id-b <id2>

# Play audio
telnyx calls:actions start-playback --call-control-id <id> --audio-url https://...

# Stop audio
telnyx calls:actions stop-playback --call-control-id <id>

# Text-to-speech
telnyx calls:actions speak --call-control-id <id> --payload "Hello, how can I help?"

# Gather DTMF input
telnyx calls:actions gather --call-control-id <id> --minimum-digits 1 --maximum-digits 4

# Send DTMF
telnyx calls:actions send-dtmf --call-control-id <id> --digits "1234"

# Start recording
telnyx calls:actions start-recording --call-control-id <id>

# Stop recording
telnyx calls:actions stop-recording --call-control-id <id>

# Start transcription
telnyx calls:actions start-transcription --call-control-id <id>

# Stop transcription
telnyx calls:actions stop-transcription --call-control-id <id>

# Start AI assistant
telnyx calls:actions start-ai-assistant --call-control-id <id> --assistant-id <id>

# Stop AI assistant
telnyx calls:actions stop-ai-assistant --call-control-id <id>
```

### Call Control Applications

```bash theme={null}
telnyx call-control-applications list
telnyx call-control-applications retrieve --id <id>
telnyx call-control-applications create --application-name "My App" --webhook-event-url https://...
telnyx call-control-applications update --id <id> --application-name "Updated"
telnyx call-control-applications delete --id <id>
```

### Conferences

```bash theme={null}
telnyx conferences list
telnyx conferences retrieve --id <id>
telnyx conferences create --call-control-id <id> --name "Team Call"

# Conference actions
telnyx conferences:actions join --id <id> --call-control-id <id>
telnyx conferences:actions mute --id <id> --call-control-ids <id1>,<id2>
telnyx conferences:actions unmute --id <id> --call-control-ids <id1>,<id2>
```

### Recordings

```bash theme={null}
telnyx recordings list
telnyx recordings retrieve --id <id>
telnyx recordings delete --id <id>

# Transcriptions
telnyx recording-transcriptions list
telnyx recording-transcriptions retrieve --id <id>
```

## AI

### Chat Completions

```bash theme={null}
telnyx ai:chat create-completion --model meta-llama/Meta-Llama-3.1-8B-Instruct \
  --messages '[{"role": "user", "content": "Hello!"}]'
```

### AI Assistants

```bash theme={null}
# List/create assistants
telnyx ai:assistants list
telnyx ai:assistants create --name "My Assistant" --model meta-llama/Meta-Llama-3.1-8B-Instruct
telnyx ai:assistants retrieve --assistant-id <id>
telnyx ai:assistants update --assistant-id <id> --name "Updated"
telnyx ai:assistants delete --assistant-id <id>

# Chat with assistant
telnyx ai:assistants chat --assistant-id <id> --conversation-id <id> --input "Hello!"

# Clone assistant
telnyx ai:assistants clone --assistant-id <id>
```

### Audio (Speech-to-Text / Text-to-Speech)

```bash theme={null}
# Transcribe audio
telnyx ai:audio create-transcription --file @audio.mp3 --model openai/whisper-large-v3

# Text-to-speech
telnyx ai:audio create-speech --input "Hello world" --voice alloy
```

### Embeddings

```bash theme={null}
telnyx ai:embeddings create --input "Your text here" --model text-embedding-ada-002
```

### Conversations

```bash theme={null}
telnyx ai:conversations list
telnyx ai:conversations create --assistant-id <id>
telnyx ai:conversations retrieve --conversation-id <id>
telnyx ai:conversations:messages list --conversation-id <id>
```

## Verify (2FA)

### Profiles

```bash theme={null}
telnyx verify-profiles list
telnyx verify-profiles retrieve --verify-profile-id <id>
telnyx verify-profiles create --name "my-app" --default-verification-timeout-secs 300
telnyx verify-profiles update --verify-profile-id <id> --name "updated"
telnyx verify-profiles delete --verify-profile-id <id>

# Message templates
telnyx verify-profiles create-template --verify-profile-id <id> --text "Your code is {{code}}"
telnyx verify-profiles retrieve-templates --verify-profile-id <id>
```

### Send Verification

```bash theme={null}
# Trigger SMS verification
telnyx verifications trigger-sms --phone-number +15551234567 --verify-profile-id <id>

# Trigger voice call verification
telnyx verifications trigger-call --phone-number +15551234567 --verify-profile-id <id>

# Trigger flash call verification
telnyx verifications trigger-flashcall --phone-number +15551234567 --verify-profile-id <id>

# Retrieve verification status
telnyx verifications retrieve --verification-id <id>
```

### Verify Code

```bash theme={null}
telnyx verifications:actions verify --verification-id <id> --code 123456
```

## Fax

```bash theme={null}
# Send fax
telnyx faxes create \
  --connection-id <id> \
  --from +15551234567 \
  --to +15559876543 \
  --media-url https://example.com/document.pdf

# List/retrieve faxes
telnyx faxes list
telnyx faxes retrieve --id <id>
telnyx faxes delete --id <id>
```

## Number Lookup

```bash theme={null}
telnyx number-lookup retrieve --phone-number +15551234567
```

## Billing

```bash theme={null}
# Check balance
telnyx balance retrieve

# Billing groups
telnyx billing-groups list
telnyx billing-groups retrieve --id <id>
telnyx billing-groups create --name "Production"
telnyx billing-groups update --id <id> --name "Updated"
telnyx billing-groups delete --id <id>
```

## SIM Cards (IoT)

```bash theme={null}
# List SIM cards
telnyx sim-cards list
telnyx sim-cards retrieve --id <id>
telnyx sim-cards update --id <id> --tags production
telnyx sim-cards delete --id <id>

# SIM card groups
telnyx sim-card-groups list
telnyx sim-card-groups create --name "Fleet 1"
telnyx sim-card-groups retrieve --id <id>
telnyx sim-card-groups delete --id <id>

# SIM card orders
telnyx sim-card-orders list
telnyx sim-card-orders create --quantity 10 --address-id <id>
```

## Porting

```bash theme={null}
# Porting orders
telnyx porting-orders list
telnyx porting-orders retrieve --id <id>
telnyx porting-orders create --phone-numbers +15551234567

# Portability check
telnyx portability-checks create --phone-numbers +15551234567

# Port-outs
telnyx portouts list
telnyx portouts retrieve --id <id>
```

## Storage

```bash theme={null}
# Presigned URLs for upload/download
telnyx storage:buckets create-presigned-url --bucket-name my-bucket --key my-file.txt
```

## Video Rooms

```bash theme={null}
# Rooms
telnyx rooms list
telnyx rooms create --unique-name "Team Meeting" --max-participants 10
telnyx rooms retrieve --room-id <id>
telnyx rooms update --room-id <id> --max-participants 20
telnyx rooms delete --room-id <id>

# Sessions
telnyx rooms:sessions list --room-id <id>

# Recordings
telnyx room-recordings list
telnyx room-recordings retrieve --room-recording-id <id>
telnyx room-recordings delete --room-recording-id <id>

# Compositions
telnyx room-compositions list
telnyx room-compositions create --room-session-id <id>
```

## Networking

### WireGuard

```bash theme={null}
telnyx wireguard-interfaces list
telnyx wireguard-interfaces create --network-id <id>
telnyx wireguard-interfaces retrieve --id <id>
telnyx wireguard-interfaces delete --id <id>

telnyx wireguard-peers list --wireguard-interface-id <id>
telnyx wireguard-peers create --wireguard-interface-id <id>
```

### Global IPs

```bash theme={null}
telnyx global-ips list
telnyx global-ips create
telnyx global-ips retrieve --id <id>
telnyx global-ips delete --id <id>
```

## Getting Help

```bash theme={null}
telnyx --help                              # General help
telnyx <resource> --help                   # Resource help
telnyx <resource> <command> --help         # Command help

# Examples
telnyx phone-numbers --help
telnyx messages send --help
telnyx calls:actions --help
```

***