# Tags

Source: https://kirora.io/docs/api/reference/tags

A tag is a label on campaigns, journeys, segments and templates, such as "Black Friday", for filtering lists and reports. A tag is not an audience: to group contacts, use a list or a segment. A tag that a segment or journey rule names cannot be deleted until the rule stops naming it.

## Endpoints

- [List tags](https://kirora.io/docs/api/reference/listTags): `GET /v1/tags`
- [Create a tag](https://kirora.io/docs/api/reference/createTag): `POST /v1/tags`
- [Rename a tag](https://kirora.io/docs/api/reference/updateTag): `PATCH /v1/tags/{id}`
- [Delete a tag](https://kirora.io/docs/api/reference/deleteTag): `DELETE /v1/tags/{id}`
- [Merge a tag into another](https://kirora.io/docs/api/reference/mergeTags): `POST /v1/tags/{id}/merge`

## The Tag object

```json
{
  "id": "018f2a4e-6b1c-7d3e-9f40-37386ae05a6b",
  "name": "name_example",
  "usage": {
    "campaigns": 0,
    "journeys": 0,
    "segments": 0,
    "templates": 0
  },
  "createdAt": "2030-03-14T09:30:00Z",
  "updatedAt": "2030-03-14T09:30:00Z"
}
```

- `id` (string, required, uuid)
- `name` (string, required)
- `usage` (object, required) — How many items of each kind carry the tag.
  - `campaigns` (integer, required, min 0)
  - `journeys` (integer, required, min 0)
  - `segments` (integer, required, min 0)
  - `templates` (integer, required, min 0)
- `createdAt` (string, required, date-time)
- `updatedAt` (string, required, date-time)