> ## 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.

# Tags

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

<Snippet file="auth-header.mdx" />

## List tags

<ParamField query="page" type="integer" default="1">Page number</ParamField>
<ParamField query="per_page" type="integer" default="25">Items per page (max 250)</ParamField>
<ParamField query="sort" type="string">Sort field</ParamField>
<ParamField query="order" type="string" default="desc">Sort order: `asc` or `desc`</ParamField>

```bash theme={null}
GET /api/v1/tags
```

## Create a tag

```bash theme={null}
POST /api/v1/tags
```

<ParamField body="name" type="string" required>Tag name (1-100 characters)</ParamField>
<ParamField body="color" type="string">Color as hex (`#RRGGBB`)</ParamField>

```bash Example theme={null}
curl -X POST https://api.mossdesk.com/api/v1/tags \
  -H "X-API-Key: moss_k_..." \
  -H "Content-Type: application/json" \
  -d '{ "name": "enterprise", "color": "#2D6A4F" }'
```

## Delete a tag

Deletes the tag and removes it from all entities.

```bash theme={null}
DELETE /api/v1/tags/:id
```