# Tags

Categorize beyond account structure—e.g., by shoot day, location, department.  
Use tags to run cross-budget reports and track spend across multiple categories.


## List tags

 - [GET /projects/{projectId}/tags](https://docs.saturation.io/openapi/tags/listtags.md): Retrieve all tags for a project with optional filtering and sorting.

Tags are used for categorizing budget line items and enable advanced filtering
capabilities across budget data. Each tag includes financial totals aggregated
from all associated budget line items.


## Create tag

 - [POST /projects/{projectId}/tags](https://docs.saturation.io/openapi/tags/createtag.md): Create a new tag for the project. Tags are used to categorize budget line items
and enable advanced filtering capabilities.

Note: Tag names cannot be changed after creation. Only the color can be updated.


## Get tag

 - [GET /projects/{projectId}/tags/{tagId}](https://docs.saturation.io/openapi/tags/gettag.md): Retrieve a specific tag by ID, including its financial totals aggregated
from all associated budget line items.


## Update tag

 - [PUT /projects/{projectId}/tags/{tagId}](https://docs.saturation.io/openapi/tags/updatetag.md): Update a tag's properties. Currently, only the color can be updated.
Tag names and descriptions cannot be modified after creation.


## Delete tag

 - [DELETE /projects/{projectId}/tags/{tagId}](https://docs.saturation.io/openapi/tags/deletetag.md): Delete a tag and remove all its assignments from budget line items.
This operation cannot be undone.