bird voice numbers update

Usage

bird voice numbers update <number-id> [flags]

Description

Update what a voice number does with a call, or its label

--route replaces whatever was set before, because a number has exactly one answer at a time: default follows the workspace route from bird voice settings, reject refuses calls, trunk needs --trunk-id and a trunk with inbound calling enabled, forward needs --forward-to and --forward-as. Only a number whose calls arrive at Bird can carry a route; sequence needs --sequence-id and --entry-node-id from a sequence created and published in the dashboard. One from another carrier is routed by that carrier. Removing the label needs an explicit null in the request body: no flag sends a null, and --body-file takes a path or "-" for stdin, never inline JSON.

Build the request from flags, a JSON VoiceNumberUpdate body via --body-file ("-" reads stdin), or both — a flag overrides the matching body field. Run --example to print a ready-to-edit body, or --dry-run to print the resolved request without sending it.

Examples

# print the body shape (no credentials needed)
bird voice numbers update --example

# the body it prints:

{
  "inbound_configuration": {
    "route": {
      "trunk_id": "spt_01krdgeqcxet5s7t44vh8rt9mg",
      "type": "trunk"
    }
  }
}

# deliver calls to a SIP trunk
bird voice numbers update vnu_123 --route trunk --trunk-id spt_456

# forward calls to a verified caller ID
bird voice numbers update vnu_123 --route forward --forward-to +14155551234 --forward-as dialed_number

# start a published sequence
bird voice numbers update vnu_123 --route sequence --sequence-id vsq_456 --entry-node-id incoming_call

# stop the number answering
bird voice numbers update vnu_123 --route reject

# follow the workspace default route again
bird voice numbers update vnu_123 --route default

# remove the label (a null only reaches the wire on stdin)
echo '{"name": null}' | bird voice numbers update vnu_123 --body-file -

Options

Inbound route

Request

Options

Related