---
title: "bird labels delete"
description: "Delete a label"
canonical: "https://bird.com/docs/cli/reference/labels-delete"
---

# `bird labels delete`

## Usage

```bash
bird labels delete <label-id> [flags]
```

## Description

Delete a label from the workspace's catalogue. It leaves every conversation and message that carried it at once. Deleting cannot be undone; creating a label with the same name later makes a new label with a new ID.

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

## Examples

```bash
bird labels delete <id> --yes
```

## Options

#### Safety

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

#### Options

| Name        | Description                                              |
| ----------- | -------------------------------------------------------- |
| `--dry-run` | Print the resolved request without sending it, then exit |

## Related

| Name                                                      | Description    |
| --------------------------------------------------------- | -------------- |
| [`bird labels create`](/docs/cli/reference/labels-create) | Create a label |
| [`bird labels get`](/docs/cli/reference/labels-get)       | Get a label    |
| [`bird labels list`](/docs/cli/reference/labels-list)     | List labels    |
| [`bird labels update`](/docs/cli/reference/labels-update) | Update a label |

## Related resources

- [What is omnichannel vs multichannel messaging?](/explained/engagement/what-is-omnichannel-vs-multichannel) (answer)
- [Build your first integration](/learn/paths/integration) (course)

[Get an implementation brief](/learn/workspace?topic=omnichannel)
