# Tag Endpoints {#tag-endpoints}


Manage tags for flexible entity categorization.


## Base Path {#base-path}


```
/api/tag
```


## Endpoints {#endpoints}



### List Tags {#list-tags}


```
GET /api/tag
Authorization: Bearer {token}
```

**Query Parameters:**

| Parameter | Type   | Description     |
| --------- | ------ | --------------- |
| `name`    | string | Filter by name  |
| `color`   | string | Filter by color |

**Response:**

```json
{
  "items": [
    { "id": "uuid", "name": "Urgent", "color": "#FF0000", "isSystem": false },
    { "id": "uuid", "name": "Frontend", "color": "#61DAFB", "isSystem": false }
  ],
  "total": 15
}
```


### Create Tag {#create-tag}


```
POST /api/tag
Authorization: Bearer {token}
```

```json
{
  "name": "Backend",
  "color": "#68A063",
  "description": "Backend related items"
}
```


### Update Tag {#update-tag}


```
PUT /api/tag/:id
Authorization: Bearer {token}
```


### Delete Tag {#delete-tag}


```
DELETE /api/tag/:id
Authorization: Bearer {token}
```


### Get Tag Usage {#get-tag-usage}


```
GET /api/tag/:id/count
Authorization: Bearer {token}
```

Returns count of entities using this tag.


## Taggable Entities {#taggable-entities}


Tags can be applied to: Tasks, Employees, Projects, Contacts, Invoices, Expenses, Equipment, Proposals.


## Related Pages {#related-pages}


- [Tags Management](https://sourcey-gauzy.pages.dev/features/tags-management/index.md) — feature guide
- [Task Endpoints](https://sourcey-gauzy.pages.dev/api/task-endpoints/index.md) — tasks API