> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coval.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Tags

> Manage the tags used to label resources with the Coval CLI

Tags are org-wide labels you can attach to agents, personas, metrics, test sets, runs, run templates, and uploaded conversations (for example with the `--tags` or `--tag` flags on those commands). Tag names are normalized to lowercase.

`create` and `update` also accept `--input-json` (inline JSON, `@file`, or `-` for stdin); explicit flags override fields from the JSON. See [Input JSON](/cli/agent-mode#input-json).

## List Tags

```bash theme={null}
coval tags list
```

**Output columns:** ID, Name, Color, Created By, Created At

## Get Tag

```bash theme={null}
coval tags get <tag_id>
```

| Argument | Type   | Required | Description |
| -------- | ------ | -------- | ----------- |
| `tag_id` | string | **Yes**  | The tag ID  |

## Create Tag

```bash theme={null}
coval tags create [OPTIONS]
```

| Option       | Type   | Required | Description                                        |
| ------------ | ------ | -------- | -------------------------------------------------- |
| `--tag-name` | string | **Yes**  | Tag display name. Normalized to lowercase          |
| `--color`    | string | No       | Hex color code (`#RGB`, `#RRGGBB`, or `#RRGGBBAA`) |

```bash theme={null}
coval tags create --tag-name "regression" --color "#3b82f6"
```

## Update Tag

```bash theme={null}
coval tags update <tag_id> [OPTIONS]
```

| Argument | Type   | Required | Description          |
| -------- | ------ | -------- | -------------------- |
| `tag_id` | string | **Yes**  | The tag ID to update |

| Option       | Type   | Description        |
| ------------ | ------ | ------------------ |
| `--tag-name` | string | New name           |
| `--color`    | string | New hex color code |

At least one of `--tag-name` or `--color` is required.

```bash theme={null}
coval tags update 01HXYZ1234567890ABCDEF --color "#ef4444"
```

## Delete Tag

```bash theme={null}
coval tags delete <tag_id>
```

| Argument | Type   | Required | Description          |
| -------- | ------ | -------- | -------------------- |
| `tag_id` | string | **Yes**  | The tag ID to delete |