Sign inGet Started

bird numbers cancel

Usage

Code example
bird numbers cancel <number-id> [flags]

Description

Stops a dedicated number renewing and keeps it allocated until the end of the period already paid for, when it is released. Cannot be undone; read releases_at for when it goes. Asking again returns the same schedule. A number with no subscription behind it is released now. Refused while a renewal payment is overdue. To give the number up now, use bird numbers release instead.

This is destructive and cannot be undone; pass --yes to confirm.

Examples

Code example
bird numbers cancel <id> --yes

Options

Safety

NameDescription
--idempotency-keyDeduplication key; a retry with the same key won't act twice
--yesConfirm a destructive action (required; the CLI never prompts)

Options

NameDescription
--response-schemaPrint the fields this command returns, then exit
NameDescription
bird numbers getGet an allocated number
bird numbers listList your allocated numbers
bird numbers releaseRelease a dedicated number
bird numbers updateUpdate an allocated number

Continue with the documentation, guides and examples for this topic.