---
title: "bird labels"
description: "Manage the workspace's conversation labels"
canonical: "https://bird.com/docs/cli/reference/labels"
---

# `bird labels`

## Usage

```bash
bird labels
```

## Description

A label has a name, an optional colour and a description of when to apply it, and keeps its
ID when renamed. Names are unique regardless of case, and a workspace creates no new label
once it has 100.

Reads return JSON. Mutations take flags and/or a --body-file JSON body (flags overriding); run --example to print the body shape or --dry-run to preview the request. Destructive commands require --yes.

## Commands

| Name                                          | Description    |
| --------------------------------------------- | -------------- |
| [`create`](/docs/cli/reference/labels-create) | Create a label |
| [`delete`](/docs/cli/reference/labels-delete) | Delete a label |
| [`get`](/docs/cli/reference/labels-get)       | Get a label    |
| [`list`](/docs/cli/reference/labels-list)     | List 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)
