Get a playlist
Fetches an object given its ID.
Authorizations
OAuth 2.1 authorization-code flow with PKCE.
Headers
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.
Path Parameters
Resource identifier.
Response
Successful response.
How the draft differs from what plays live. An item at the same position is
unchanged, not moved. When nothing is live, every item is unchanged.
The draft has edits the live stream does not play yet (publish to put them on air).
video, audio The items the live stream plays, in order (empty when nothing is live yet).
The draft version the live stream plays (0 when nothing is live yet).
sequential, shuffle Where the latest publish is.
IDLE, PENDING, PREPARING, FAILED, NOT_LIVE The draft's version, bumped by 1 per committed edit batch. Pass it back to playlist edits for optimistic concurrency.
The scene that owns this playlist (scn_…); null for a stream playlist.