band number deactivate

Deactivate voice or messaging services on phone numbers

Synopsis

Creates a service deactivation order to disable voice and/or messaging services on one or more phone numbers via the Universal Platform.

At least one service flag must be provided. Use --dry-run to inspect the eligibility matrix (which mirrors activate's). Use --wait to block until the order reaches a terminal status.

Underlying API: POST /api/v2/accounts/{accountId}/serviceActivation with action=DEACTIVATE

band number deactivate <number...> [flags]

Examples

  # Disable inbound voice on a number
  band number deactivate +19195551234 --voice-inbound

  # Disable inbound voice and wait for the order to settle
  band number deactivate +19195551234 --voice-inbound --wait

Options

      --customer-order-id string       Optional customer-supplied order ID for tracking
      --dry-run                        Run the eligibility checker instead of creating an order
  -h, --help                           help for deactivate
      --messaging                      Target the messaging (ALL) service
      --timeout duration               Maximum time to wait when --wait is set (default 60s) (default 1m0s)
      --voice-inbound                  Target the voice INBOUND service
      --voice-outbound-international   Target the voice OUTBOUND_INTERNATIONAL service
      --voice-outbound-national        Target the voice OUTBOUND_NATIONAL service
      --wait                           Block until the order reaches a terminal status

Options inherited from parent commands

      --account-id string    Bandwidth account ID (overrides config)
      --environment string   API environment: prod, test (overrides config)
      --format string        Output format: json or table (default "json")
      --plain                Simplified flat JSON output (recommended for scripts and agents)

SEE ALSO

• band number - Manage Bandwidth phone numbers