playlists
Get a playlist
Fetches an object given its ID.
get/playlists/{id}
Path parameters
idstring required
Resource identifier.
Response
Successful response.
copiedFromstring nullable
createdAtstring date-time required
hasUnpublishedChangesboolean required
snapshot != nil && Playlist.version > snapshot.version. Returns false during the B-11 STREAMING+no-snapshot window — deliberate: the stream is live but nothing has been published yet.
idstring required
kind'video' | 'audio' required
liveVersioninteger required
PlaylistSnapshot.version — Playlist.version frozen at the last LIVE write. Returns 0 when no snapshot exists OR during the B-11 STREAMING+no-snapshot transient window (WriteInitialPlaylistSnapshot retry).
mode'sequential' | 'shuffle' required
publishStatus'IDLE' | 'PENDING' | 'PREPARING' | 'FAILED' | 'NOT_LIVE' required
Workflow-state derivation. NB-13: PREPARING wins over PENDING even when a concurrent edit advances Playlist.version while a publish is preparing.
streamIDstring required
updatedAtstring date-time required
versioninteger required
Bumped by 1 per committed spec mutation batch. Used for optimistic concurrency and as the snapshot handle for PreparePlaylistWorkflow.