# `bird numbers release`

## Usage

```bash
bird numbers release <number-id> [flags]
```

## Description

Gives a dedicated number back and stops its monthly charge. Irreversible: the number leaves the workspace and the channels built on it stop sending. A shared number cannot be released.

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

## Examples

```bash
bird numbers release <id> --yes
```

## Options

#### Safety

| Name                | Description                                                    |
| ------------------- | -------------------------------------------------------------- |
| `--idempotency-key` | Deduplication key; a retry with the same key won't act twice   |
| `--yes`             | Confirm a destructive action (required; the CLI never prompts) |

## Related

| Name                                                    | Description                 |
| ------------------------------------------------------- | --------------------------- |
| [`bird numbers get`](/docs/cli/reference/numbers-get)   | Get an allocated number     |
| [`bird numbers list`](/docs/cli/reference/numbers-list) | List your allocated numbers |