<!-- https://developers.silktide.com/v1/platform/tags | Platform -->

# Tags

A tag is a label the account makes, such as "Competitor" or "Pre-production", and puts on things to group and filter them, in Silktide and in reports. Silktide 5 calls them labels; the API keeps the name tags, so `tagId` and `tagIds` are the same labels people see.

Each tag is for one kind of thing, its `entityType`:

| `entityType` | Goes on |
| --- | --- |
| `section` | Websites and their sections. |
| `document` | Documents. |
| `task` | Tasks. |

Tags of different types never mix: a website tag and a task label can share a name and still be two tags. A tag can belong to a tag group, such as "Region", so related tags are shown together.

These operations create, change and delete the tags themselves. To put tags on a website, send their ids as `tagIds` to [Update a website](https://developers.silktide.com/v1/governance/websites/update-website.md); [Tag websites](https://developers.silktide.com/guides/tag-websites.md) walks through it.

In Silktide itself: [Labels screen](https://docs.silktide.com/settings/screens/labels), in Help.
## Operations

- [List the account's tags](https://developers.silktide.com/v1/platform/tags/list-tags.md): `GET /v1/tags`
- [Create one or more tags](https://developers.silktide.com/v1/platform/tags/create-tag.md): `POST /v1/tags`
- [Update a tag](https://developers.silktide.com/v1/platform/tags/update-tag.md): `PUT /v1/tags/{tagId}`
- [Delete a tag and remove it everywhere](https://developers.silktide.com/v1/platform/tags/delete-tag.md): `DELETE /v1/tags/{tagId}`
