# polymorfa label

> Manage Messaging labels and chat assignments.

## Commands

- [polymorfa label chat list](https://docs.polymorfa.com/cli/label/chat-list): List the labels assigned to a chat.
- [polymorfa label chat replace](https://docs.polymorfa.com/cli/label/chat-replace): Replace a chat's complete label set.
- [polymorfa label create](https://docs.polymorfa.com/cli/label/create): Create a label.
- [polymorfa label delete](https://docs.polymorfa.com/cli/label/delete): Delete a label.
- [polymorfa label list](https://docs.polymorfa.com/cli/label/list): List labels for a Messaging session.
- [polymorfa label update](https://docs.polymorfa.com/cli/label/update): Update a label.

## polymorfa label chat list

List the labels assigned to a chat.

### Usage

```bash
polymorfa label chat list CHAT [flags]
```

### Arguments

- `CHAT` (required). Polymorfa conversation ID.

### Flags

- `--include-observation` (boolean). Include observation policy and freshness metadata.
- `--session <value>` (value, required). Messaging session ID.

Also accepts the [global flags](https://docs.polymorfa.com/cli#global-flags).

## polymorfa label chat replace

Replace a chat's complete label set.

### Usage

```bash
polymorfa label chat replace CHAT [flags]
```

### Arguments

- `CHAT` (required). Polymorfa conversation ID.

### Flags

- `--clear` (boolean). Detach every label from the chat.
- `--idempotency-key <value>` (value). Safely identify retries of this replacement.
- `--label <value>` (value, repeatable). Label ID. Repeat to assign multiple labels.
- `--session <value>` (value, required). Messaging session ID.

Also accepts the [global flags](https://docs.polymorfa.com/cli#global-flags).

## polymorfa label create

Create a label.

### Usage

```bash
polymorfa label create [flags]
```

### Flags

- `--color <value>` (value). Label color index.
- `--idempotency-key <value>` (value). Safely identify retries of this create operation.
- `--name <value>` (value, required). Label name.
- `--session <value>` (value, required). Messaging session ID.

Also accepts the [global flags](https://docs.polymorfa.com/cli#global-flags).

## polymorfa label delete

Delete a label.

### Usage

```bash
polymorfa label delete LABEL [flags]
```

### Arguments

- `LABEL` (required). Label ID.

### Flags

- `--idempotency-key <value>` (value). Safely identify retries of this delete operation.
- `--session <value>` (value, required). Messaging session ID.
- `--yes` (boolean, required). Confirm permanent label deletion.

Also accepts the [global flags](https://docs.polymorfa.com/cli#global-flags).

## polymorfa label list

List labels for a Messaging session.

### Usage

```bash
polymorfa label list [flags]
```

### Flags

- `--include-observation` (boolean). Include observation policy and freshness metadata.
- `--session <value>` (value, required). Messaging session ID.

Also accepts the [global flags](https://docs.polymorfa.com/cli#global-flags).

## polymorfa label update

Update a label.

### Usage

```bash
polymorfa label update LABEL [flags]
```

### Arguments

- `LABEL` (required). Label ID.

### Flags

- `--color <value>` (value). New label color index.
- `--idempotency-key <value>` (value). Safely identify retries of this update operation.
- `--name <value>` (value). New label name.
- `--session <value>` (value, required). Messaging session ID.

Also accepts the [global flags](https://docs.polymorfa.com/cli#global-flags).
