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

# tag

> Create, list, update, and delete tags for categorizing contacts, companies, and deals.

Tags let you categorize and filter contacts, companies, and deals. Use them to segment your data however makes sense for your workflow — by industry, priority, source, or anything else.

## moss tag list

List all tags in the workspace.

```bash theme={null}
moss tag list
```

| Option           | Required | Description                  |
| ---------------- | -------- | ---------------------------- |
| `--page <n>`     | No       | Page number                  |
| `--per-page <n>` | No       | Items per page               |
| `--sort <field>` | No       | Sort field                   |
| `--order <dir>`  | No       | Sort order (`asc` or `desc`) |

## moss tag create

Create a new tag.

```bash theme={null}
moss tag create --name "enterprise" --color "#2D6A4F"
```

| Option            | Required | Description              |
| ----------------- | -------- | ------------------------ |
| `--name <name>`   | Yes      | Tag name                 |
| `--color <color>` | No       | Color as hex (`#RRGGBB`) |

## moss tag update

Update a tag's name or color.

```bash theme={null}
moss tag update --id tag_abc123 --name "Enterprise" --color "#1B4332"
```

| Option            | Required | Description                  |
| ----------------- | -------- | ---------------------------- |
| `--id <id>`       | Yes      | Tag ID                       |
| `--name <name>`   | No       | New tag name                 |
| `--color <color>` | No       | New color as hex (`#RRGGBB`) |

## moss tag delete

Delete a tag. This removes the tag from all entities it's applied to.

```bash theme={null}
moss tag delete --id tag_abc123 --confirm
```

| Option      | Required | Description                                            |
| ----------- | -------- | ------------------------------------------------------ |
| `--id <id>` | Yes      | Tag ID                                                 |
| `--confirm` | Yes      | Confirm deletion (required for destructive operations) |

<Warning>
  Deleting a tag removes it from every contact, company, and deal it's applied to.
</Warning>