Playlists

List all playlists

Changed on Sep 28, 2026

Returns a list of all playlists for the authenticated user

get/v1/playlists

Request

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

Query parameters

visibility'org' | 'personal'

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

Example:org

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

cursorstring

Pagination cursor from previous response

Example:eyJpZCI6InBsX3h5eiJ9

limitinteger

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

Example:20

Response

Example response

{
  "pagination": {
    "hasMore": true,
    "nextCursor": "eyJpZCI6IjEyMyJ9"
  },
  "playlists": [
    {
      "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