Documentation
Sign inGet started

Release a dedicated number

DELETE
/v1/numbers/{number_id}
// Releasing stops the monthly charge and the number stops working for you.
// Only a dedicated number can be released; a shared one answers E14002.
await bird.numbers.release("nda_01krdgeqcxet5s7t44vh8rt9mg");
Releases one of your workspace's dedicated numbers and stops its monthly charge. Your workspace can no longer use the number after release. Shared numbers cannot be released because they serve multiple workspaces.
Parameters
number_id
string
Identifier of the number to release, as returned in the id field of GET /v1/numbers.