# tags

> Contact tags.

Contact tags.

| Method | Path | Operation | Scope | Test mode |
|---|---|---|---|---|
| GET | `/v1/tags` | `tags_list`: List contact tags | `contacts:read` | yes |
| POST | `/v1/tags` | `tags_create`: Create a tag | `contacts:write` | yes |
| DELETE | `/v1/tags/{tag_id}` | `tags_delete`: Delete a tag (removes it from every contact) | `contacts:write` | yes |
| GET | `/v1/tags/{tag_id}` | `tags_get`: Get a tag | `contacts:read` | yes |
| PATCH | `/v1/tags/{tag_id}` | `tags_update`: Rename or recolour a tag | `contacts:write` | yes |

Request and response schemas: the interactive reference at `https://api.wapitick.com/docs`, or `docs/api/openapi.json`.
