# `bird email dedicated-ips delete`

## Usage

```bash
bird email dedicated-ips delete <dedicated-ip-id> [flags]
```

## Description

Cancel a dedicated IP subscription by id. The IP stays usable until the end of the billing period. The last IP in the default pool cannot be canceled. Destructive and billing-affecting.

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

## Examples

```bash
bird email dedicated-ips delete <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 email dedicated-ips assign`](/docs/cli/reference/email-dedicated-ips-assign) | Move a dedicated IP to a pool |
| [`bird email dedicated-ips create`](/docs/cli/reference/email-dedicated-ips-create) | Purchase a dedicated IP       |
| [`bird email dedicated-ips get`](/docs/cli/reference/email-dedicated-ips-get)       | Get a dedicated IP            |
| [`bird email dedicated-ips list`](/docs/cli/reference/email-dedicated-ips-list)     | List dedicated IPs            |