# `bird preferences delete`

## Usage

```bash
bird preferences delete <preference-id> [flags]
```

## Description

Delete a recorded preference, returning its key to having no record at all. Refused on a statement the person made themselves: an unsubscribe or a stop keyword is theirs to reverse, not the workspace's.

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

## Examples

```bash
bird preferences 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) |

#### Options

| Name                | Description                                      |
| ------------------- | ------------------------------------------------ |
| `--response-schema` | Print the fields this command returns, then exit |

## Related

| Name                                                                | Description         |
| ------------------------------------------------------------------- | ------------------- |
| [`bird preferences create`](/docs/cli/reference/preferences-create) | Record a preference |
| [`bird preferences get`](/docs/cli/reference/preferences-get)       | Get a preference    |
| [`bird preferences list`](/docs/cli/reference/preferences-list)     | List preferences    |