Sign in
Playlists

Create a new playlist

Create a new playlist for the authenticated user

post/v1/playlists

Request body

descriptionstring

Playlist description

emojistring

Unicode emoji character for the playlist

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

Access level: public (anyone with link), private (org members only), 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

OK

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

No recorded changes to this endpoint across all 1 revision of this API.