Skip to main content
GET
List playlists

Authorizations

Authorization
string
header
required

OAuth 2.1 authorization-code flow with PKCE.

Headers

X-Workspace-Id
string

Workspace this request operates in — the workspace id (wksp_…) or the organization id, from GET /workspaces. Required with an API key, which carries no workspace (400 WORKSPACE_REQUIRED without it). With an OAuth token it defaults to the workspace the token was issued for. Responds 403 WORKSPACE_FORBIDDEN when the caller is not a current member, rather than falling back to another workspace.

Query Parameters

limit
integer
default:20

Maximum items to return (1-100, default 20).

Required range: 1 <= x <= 100
cursor
string

Pagination cursor from a previous response's page.nextCursor.

streamId
string

Only the playlists of this stream (stream_…).

sceneId
string

Only the playlists of this scene (scn_…).

Response

Successful response.

A page of playlist items.

data
object[]
required
page
object
required

Cursor-pagination metadata.