# Tags

Our mechanism for indicating constraints, penalties or preferences.

## Get all tags for a planning

 - [GET /v1/plannings/{id}/tags/](https://docs.adm.wearetransformers.nl/apis/schema/tags/v1_plannings_tags_list.md): Lists all tags for a planning.

## Creates a new tag

 - [POST /v1/tags/](https://docs.adm.wearetransformers.nl/apis/schema/tags/v1_tags_create.md): Creates a new tag.

## v1_tags_partial_update

 - [PATCH /v1/tags/{uuid}/](https://docs.adm.wearetransformers.nl/apis/schema/tags/v1_tags_partial_update.md): Helpers for workspace-aware StableEntity CRUD writes.

Contract:
- Reads may target any non-archived workspace (middleware validated).
- Writes must target a DRAFT workspace (enforced via get_workspace_for_write()).

## Delete a tag

 - [DELETE /v1/tags/{uuid}/](https://docs.adm.wearetransformers.nl/apis/schema/tags/v1_tags_destroy.md): Deletes a tag.