> ## Documentation Index
> Fetch the complete documentation index at: https://www.tella.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Tags

> Categorize and filter your library with workspace and private tags.

Tags categorize videos across your library. Workspace tags are shared with everyone in the workspace; private tags are only visible to you. Filter your library by tag with `list_videos`' `tagIds` parameter.

## list\_tags

List all tags visible to you: the workspace's shared tags plus your private tags.

No parameters.

## create\_tag

Create a tag for categorizing videos. When no color is given, one is derived from the name.

<ParamField path="name" type="string" required>
  Tag name
</ParamField>

<ParamField path="scope" type="enum<string>">
  Tag visibility — `workspace` (default) or `private`
</ParamField>

<ParamField path="color" type="string">
  Tag color as a hex value, e.g. `#6366f1`
</ParamField>

<ParamField path="description" type="string">
  Tag description
</ParamField>

## update\_tag

Update a tag's name, color, and/or description. Private tags can only be updated by their creator.

<ParamField path="id" type="string" required>
  Tag ID
</ParamField>

<ParamField path="name" type="string">
  New tag name
</ParamField>

<ParamField path="color" type="string">
  New tag color as a hex value, e.g. `#6366f1`
</ParamField>

<ParamField path="description" type="string">
  New tag description
</ParamField>

## delete\_tag

Permanently delete a tag and remove it from all videos.

<ParamField path="id" type="string" required>
  Tag ID
</ParamField>

## list\_video\_tags

List the tags on a video that are visible to you.

<ParamField path="videoId" type="string" required>
  Video ID
</ParamField>

## add\_video\_tag

Tag a video. Requires edit access to the video. Adding a private tag only affects your own library.

<ParamField path="videoId" type="string" required>
  Video ID
</ParamField>

<ParamField path="tagId" type="string" required>
  Tag ID
</ParamField>

## remove\_video\_tag

Untag a video. Requires edit access to the video.

<ParamField path="videoId" type="string" required>
  Video ID
</ParamField>

<ParamField path="tagId" type="string" required>
  Tag ID
</ParamField>


## Related topics

- [Delete a tag](/docs/api-reference/tags/delete-a-tag.md)
- [Update a tag](/docs/api-reference/tags/update-a-tag.md)
- [List all tags](/docs/api-reference/tags/list-all-tags.md)
- [Add a tag to a video](/docs/api-reference/tags/add-a-tag-to-a-video.md)
- [List a video's tags](/docs/api-reference/tags/list-a-videos-tags.md)