band portin supp

Supplement an existing port-in order (change FOC, site, peer, etc.)

Synopsis

Sends a supplement (PUT) to an existing port-in order and waits for the change to propagate. The Bandwidth API has a documented behavior where a supp on a wireless_to_wireless order past FOC returns 200 on the PUT but sets error code 7300 on the next GET — meaning Neustar never received the change. This command always polls until either the order's last-modified timestamp advances past the pre-PUT value, or 7300 surfaces, or the timeout expires. Exit 1 on 7300 with a clear message; exit 5 on timeout.

band portin supp <order-id> [flags]

Examples

  band portin supp b9ef682b-2b42-4287-bfe4-ba03ec57cb07 --foc 2026-06-01T15:30:00Z
  band portin supp b9ef682b --site 1234 --peer 5678 --timeout 60s

Options

      --foc string         Requested FOC date-time (YYYY-MM-DDTHH:MM:SSZ, e.g. 2026-06-01T15:30:00Z)
  -h, --help               help for supp
      --peer string        SIP peer (location) ID to switch the order to
      --site string        Site (sub-account) ID to switch the order to
      --timeout duration   Maximum time to wait for propagation (default 30s) (default 30s)

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 portin - Manage port-in orders (single, bulk, toll-free)