> ## 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.

# Legacy Command Reference

> Complete command reference for the deprecated @telnyx/api-cli Node.js CLI, retained for legacy projects. New projects should use the current Telnyx CLI.

<Warning>
  **This CLI is deprecated.** For the current CLI commands, see [Command Reference](/development/cli/reference).
</Warning>

## Authentication & Profiles

```bash theme={null}
telnyx auth setup                    # Interactive API key setup
telnyx auth setup --profile prod     # Setup named profile
telnyx auth status                   # Check current auth status

telnyx profile list                  # List all profiles
telnyx profile set-default <name>    # Set default profile
telnyx profile delete <name>         # Delete a profile
```

## Phone Numbers

### Search & Purchase

```bash theme={null}
# Search available numbers
telnyx number search --country US
telnyx number search --country US --contains 555
telnyx number search --country US --type toll_free
telnyx number search --country CA --locality Toronto --limit 20

# Purchase numbers
telnyx number order +15551234567
telnyx number order +15551234567 +15559876543 --messaging-profile-id <id>
```

### Manage Numbers

```bash theme={null}
telnyx number list
telnyx number list --status active
telnyx number list --tag production

telnyx number get +15551234567
telnyx number update +15551234567 --connection-id <id>
telnyx number update +15551234567 --tags production,us-west
telnyx number delete +15551234567 --force
telnyx number delete +15551234567 --dry-run
```

## Messaging

### Send Messages

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

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

### List & Retrieve

```bash theme={null}
telnyx message list
telnyx message list --direction outbound --limit 50
telnyx message list --from +15551234567
telnyx message get <message-id>
```

### Messaging Profiles

```bash theme={null}
telnyx messaging-profile list
telnyx messaging-profile get <id>
telnyx messaging-profile create --name "Production" --webhook-url https://...
telnyx messaging-profile update <id> --webhook-url https://...
telnyx messaging-profile delete <id> --force
```

## Voice

### Make Calls

```bash theme={null}
telnyx call dial --from +15551234567 --to +15559876543 --connection-id <id>
telnyx call dial -f +15551234567 -t +15559876543 --connection-id <id>

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

### Call Control

```bash theme={null}
telnyx call list
telnyx call list --direction outgoing --status active
telnyx call hangup <call-control-id>
telnyx call speak <call-control-id> "Hello, how can I help you?"
telnyx call transfer <call-control-id> +15559876543
telnyx call playback <call-control-id> --audio-url https://...
```

### Voice Profiles & Connections

```bash theme={null}
telnyx voice-profile list
telnyx voice-profile get <id>
telnyx voice-profile create --name "Production" --concurrent-call-limit 100

telnyx connection list
telnyx connection list --type credential
telnyx connection create --name "My Voice App" --type credential --webhook-url https://...
```

## 10DLC

### Interactive Setup

```bash theme={null}
telnyx 10dlc wizard                  # Guided setup wizard
```

### Brand Management

```bash theme={null}
telnyx 10dlc brand list
telnyx 10dlc brand get <brand-id>
telnyx 10dlc brand create --display-name "My Company" --entity-type PRIVATE_PROFIT
```

### Campaign Management

```bash theme={null}
telnyx 10dlc campaign list
telnyx 10dlc campaign get <campaign-id>
telnyx 10dlc campaign create --brand-id <id> --use-case MARKETING
```

## Billing

```bash theme={null}
telnyx billing balance               # Check account balance
```

## Verification

```bash theme={null}
telnyx verify start +15551234567 --channel sms
telnyx verify check <verification-id> --code 123456
```

## Shell Autocomplete

```bash theme={null}
telnyx autocomplete                  # Setup instructions
telnyx autocomplete bash             # Bash completion script
telnyx autocomplete zsh              # Zsh completion script
```

## Global Options

| Flag               | Description                               |
| ------------------ | ----------------------------------------- |
| `--api-key <key>`  | Override API key                          |
| `--profile <name>` | Use specific profile                      |
| `--json`           | Output as JSON                            |
| `--help`           | Show command help                         |
| `--version`        | Show CLI version                          |
| `--dry-run`        | Preview without executing (some commands) |

## Migration to New CLI

See the [Legacy CLI Overview](/development/cli/legacy) for a command mapping to the new Go-based CLI.