Playlists

Create a new playlist

Changed on Sep 28, 2026

Create a new playlist for the authenticated user

post/v1/playlists

Request

Base URL
https://api.tella.com
Auth
HTTP bearer
TypeScript
https://skmtc.dev/withchima/apis/tella-public-api/docs/v1/playlists/post.ts
A function with typed inputs. Its response is checked against the schema.

Request body

descriptionstring

Playlist description

emojistring

Unicode emoji character for the playlist

linkScope'public' | 'private' | 'password' | 'embedonly'

Access level: public (anyone with link), private (only invited users, plus the workspace when visibility is org), password (requires password), embedonly (only viewable when embedded)

namestring required

Playlist name (required)

passwordstring

Password for viewing. Required when linkScope is 'password', ignored otherwise.

searchEngineIndexingEnabledboolean

Allow search engine indexing (default: false)

visibility'org' | 'personal'

Visibility: org (shared with entire organization) or personal (only creator)

Example request

{
  "description": "A collection of tutorial videos",
  "emoji": "🎬",
  "linkScope": "public",
  "name": "Product Tutorials",
  "password": "secretpassword",
  "visibility": "org"
}

Response

Example response

{
  "playlist": {
    "createdAt": "2024-01-15T10:30:00.000Z",
    "description": "A collection of tutorial videos for our product",
    "emoji": "🎬",
    "groupId": "pg_abc123def456",
    "id": "pl_abc123def456",
    "linkScope": "public",
    "links": {
      "viewPage": "https://www.tella.tv/playlist/pl_abc123def456/view"
    },
    "name": "Product Tutorials",
    "searchEngineIndexingEnabled": true,
    "updatedAt": "2024-01-15T14:45:00.000Z",
    "videos": 12,
    "visibility": "org"
  }
}

Changes

Sep 28, 2026ac47c99c144f Revision changes
- warning
  added the new edit_conflict enum value to the response property for the response status
- warning
  added the new edit_conflict enum value to the response property for the response status
- warning
  added the new edit_conflict enum value to the response property for the response status
- warning
  added the new edit_conflict enum value to the response property for the response status
- warning
  added the new edit_conflict enum value to the response property for the response status
- warning
  added the new edit_conflict enum value to the response property for the response status
- warning
  added the new edit_conflict enum value to the response property for the response status
- warning
  added the new edit_conflict enum value to the response property for the response status
- warning
  added the new edit_conflict enum value to the response property for the response status
Sep 9, 20266b1132ef42fb Revision changes
- warning
  added the new conflict enum value to the response property for the response status
- warning
  added the new conflict enum value to the response property for the response status
- warning
  added the new conflict enum value to the response property for the response status
- warning
  added the new conflict enum value to the response property for the response status
- warning
  added the new conflict enum value to the response property for the response status
- warning
  added the new conflict enum value to the response property for the response status
- warning
  added the new conflict enum value to the response property for the response status
- warning
  added the new unavailable enum value to the response property for the response status
- warning
  added the new unavailable enum value to the response property for the response status
- warning
  added the new unavailable enum value to the response property for the response status
- warning
  added the new unavailable enum value to the response property for the response status
- warning
  added the new unavailable enum value to the response property for the response status
- warning
  added the new unavailable enum value to the response property for the response status
- warning
  added the new unavailable enum value to the response property for the response status
- info
  added the non-success response with the status
- info
  added the non-success response with the status

Operation history