# Tags

## List tags

 - [GET /v1/tags](https://docs.apiera.io/openapi/tags/paths/~1v1~1tags/get.md): Retrieves a paginated list of tags with optional filtering.

## Create tag

 - [POST /v1/tags](https://docs.apiera.io/openapi/tags/paths/~1v1~1tags/post.md): Creates a new tag.

## Bulk create tags

 - [POST /v1/tags/bulk](https://docs.apiera.io/openapi/tags/paths/~1v1~1tags~1bulk/post.md): Creates multiple tags in a single atomic operation.

## Bulk update tags

 - [PATCH /v1/tags/bulk](https://docs.apiera.io/openapi/tags/paths/~1v1~1tags~1bulk/patch.md): Updates multiple tags in a single operation.

## Get tag

 - [GET /v1/tags/{tagUuid}](https://docs.apiera.io/openapi/tags/paths/~1v1~1tags~1%7Btaguuid%7D/get.md): Retrieves complete details for a single tag.

## Update tag

 - [PATCH /v1/tags/{tagUuid}](https://docs.apiera.io/openapi/tags/paths/~1v1~1tags~1%7Btaguuid%7D/patch.md): Updates an existing tag. Only provided fields are updated.

## Delete tag

 - [DELETE /v1/tags/{tagUuid}](https://docs.apiera.io/openapi/tags/paths/~1v1~1tags~1%7Btaguuid%7D/delete.md): Permanently deletes a tag. Cannot be undone.

## Transition tag lifecycle

 - [PATCH /v1/tags/{tagUuid}/actions/lifecycle](https://docs.apiera.io/openapi/tags/paths/~1v1~1tags~1%7Btaguuid%7D~1actions~1lifecycle/patch.md): Transitions a tag to a different lifecycle state. Valid transitions depend on current status.

## Bulk transition tag lifecycle

 - [PATCH /v1/tags/bulk/actions/lifecycle](https://docs.apiera.io/openapi/tags/paths/~1v1~1tags~1bulk~1actions~1lifecycle/patch.md): Transitions multiple tags to a different lifecycle state in a single operation.