> ## 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.

# Playlists

> Create playlists and sidebar groups, and organize videos into them.

## list\_playlists

List all playlists in your workspace.

<ParamField path="visibility" type="enum<string>">
  Filter by `personal` or `org`
</ParamField>

<ParamField path="cursor" type="string">
  Pagination cursor
</ParamField>

<ParamField path="limit" type="integer">
  Items per page (1-100, default: 20)
</ParamField>

## create\_playlist

Create a new playlist.

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

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

<ParamField path="emoji" type="string">
  Emoji icon
</ParamField>

<ParamField path="visibility" type="enum<string>">
  `personal` (default) or `org`
</ParamField>

<ParamField path="linkScope" type="enum<string>">
  Access level — `public` (default), `private`, `password`, or `embedonly`
</ParamField>

<ParamField path="password" type="string">
  Password for protected playlists
</ParamField>

## get\_playlist

Get detailed information about a playlist. Outside your workspace, you can only access a playlist with an ungated public link.

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

## update\_playlist

Update playlist metadata and settings.

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

<ParamField path="name" type="string">
  Playlist name
</ParamField>

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

<ParamField path="emoji" type="string">
  Emoji icon
</ParamField>

<ParamField path="linkScope" type="enum<string>">
  Access level — `public`, `private`, `password`, or `embedonly`
</ParamField>

<ParamField path="password" type="string">
  Password for protected playlists
</ParamField>

<ParamField path="searchEngineIndexingEnabled" type="boolean">
  Allow search engine indexing
</ParamField>

## delete\_playlist

Delete a playlist.

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

## add\_video\_to\_playlist

Add a video to a playlist.

<ParamField path="playlistId" type="string" required>
  Playlist ID
</ParamField>

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

## remove\_video\_from\_playlist

Remove a video from a playlist.

<ParamField path="playlistId" type="string" required>
  Playlist ID
</ParamField>

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

## list\_playlist\_groups

List sidebar playlist groups.

Personal groups are only visible to the authenticated user. Org groups are shared with the whole workspace.

<ParamField path="visibility" type="enum<string>">
  Filter by `personal` or `org`
</ParamField>

## create\_playlist\_group

Create a sidebar group to organize playlists into.

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

<ParamField path="emoji" type="string">
  Emoji icon
</ParamField>

<ParamField path="visibility" type="enum<string>">
  `personal` or `org`. Defaults to `personal`
</ParamField>

## update\_playlist\_group

Rename a playlist group, change its icon, or move it within its sidebar section.

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

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

<ParamField path="emoji" type="string">
  Emoji icon
</ParamField>

<ParamField path="position" type="integer">
  0-based position in the sidebar section
</ParamField>

## delete\_playlist\_group

Delete a playlist group.

Playlists inside the group are not deleted. They become ungrouped.

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

## move\_playlist\_to\_group

Move a playlist into a group, or remove it from its group.

The group's visibility must match the playlist's visibility. Org playlists can only move into org groups, and personal playlists can only move into personal groups.

<ParamField path="playlistId" type="string" required>
  Playlist ID
</ParamField>

<ParamField path="groupId" type="string">
  Target playlist group ID. Omit it to remove the playlist from its group
</ParamField>

<ParamField path="position" type="integer">
  0-based position in the target group, or in the ungrouped sidebar section when `groupId` is omitted
</ParamField>


## Related topics

- [Playlist created](/docs/api-reference/playlists/playlist-created.md)
- [Delete a playlist](/docs/api-reference/playlists/delete-a-playlist.md)
- [Update a playlist](/docs/api-reference/playlists/update-a-playlist.md)
- [Organize playlists with groups](/docs/help/sharing/organize-playlists-with-groups.md)
- [Organize your playlists](/docs/help/sharing/organize-your-playlists.md)