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

# tags

> DevHelm CLI tags commands — list, get, create, update, and delete tags

Manage tags from the command line. Create tags for organizing monitors and routing alerts.

## Commands

| Command                    | Description     |
| -------------------------- | --------------- |
| `devhelm tags list`        | List all tags   |
| `devhelm tags get <id>`    | Get tag details |
| `devhelm tags create`      | Create a tag    |
| `devhelm tags update <id>` | Update a tag    |
| `devhelm tags delete <id>` | Delete a tag    |

## tags list

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

## tags get

Tag IDs are UUIDs — get them from `devhelm tags list`.

```bash theme={null}
devhelm tags get <tag-id>
```

## tags create

```bash theme={null}
devhelm tags create --name production --color "#10b981"
```

| Flag      | Type   | Required | Description                                                        |
| --------- | ------ | -------- | ------------------------------------------------------------------ |
| `--name`  | string | Yes      | Tag name, unique within the organization                           |
| `--color` | string | —        | Hex color code (e.g., `#10b981`; defaults to `#6B7280` if omitted) |

## tags update

```bash theme={null}
devhelm tags update <tag-id> --name staging --color "#f59e0b"
```

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

## tags delete

Prompts for confirmation; pass `--yes` (`-y`) in scripts and CI.

```bash theme={null}
devhelm tags delete <tag-id>
```

## Next steps

<CardGroup cols={2}>
  <Card title="Monitors" icon="signal" href="/cli/commands/monitors">
    Assign tags when creating monitors.
  </Card>

  <Card title="Notification policies" icon="bell" href="/cli/commands/notification-policies">
    Route alerts based on tags.
  </Card>
</CardGroup>