Skip to main content
GET
/
v1
/
playlists
List all playlists
curl --request GET \
  --url https://api.tella.com/v1/playlists \
  --header 'Authorization: Bearer <token>'
{
  "playlists": [
    {
      "id": "pl_abc123def456",
      "name": "Product Tutorials",
      "description": "A collection of tutorial videos for our product",
      "emoji": "🎬",
      "videos": 12,
      "linkScope": "public",
      "searchEngineIndexingEnabled": true,
      "visibility": "org",
      "createdAt": "2024-01-15T10:30:00.000Z",
      "updatedAt": "2024-01-15T14:45:00.000Z",
      "links": {
        "viewPage": "https://www.tella.tv/playlist/pl_abc123def456/view"
      }
    }
  ],
  "pagination": {
    "nextCursor": "eyJpZCI6IjEyMyJ9",
    "hasMore": true
  }
}

Authorizations

Authorization
string
header
required

API key obtained from your Tella account settings

Query Parameters

visibility
enum<string>
default:personal

Filter by visibility: personal (only your playlists) or org (shared with organization). Default: personal

Available options:
org,
personal
Example:

"org"

cursor
string

Pagination cursor from previous response

Example:

"eyJpZCI6InBsX3h5eiJ9"

limit
integer

Items per page (default: 20, max: 100)

Required range: 1 <= x <= 100
Example:

20

Response

OK

playlists
object[]
required

List of playlists

pagination
object
required

Pagination metadata for list responses. Results are sorted by updatedAt descending.