Get an existing standard playlist

Prev Next
Get
/v{version}/Playlists/{id}

The active version is only displayed if it is released.

Security
API Key: api_key
Header parameter nameX-ApiKey

Api Key

API Key: session_id
Header parameter nameX-Session-Id

Session Id

Path parameters
id
integer (int32) Required

Unique ID of the playlist

version
stringRequired

The requested API version

Query parameters
includeAllVersions
boolean

If true, the property Versions is populated. Default: false.

includeTags
boolean

If true, the property Tags is populated. Default: false.

Responses
200

Returns the playlist.

Expand All
object

Playlist response model with detailed user group permissions

ActiveVersion
object (V1.Models.Playlist.Version)

Playlist version

Id
integer (int32)

Unique ID of the playlist version

Name
string

Name of the playlist version

PlaylistId
integer (int32)

Playlist ID of the playlist version

Status
string

Status of playlist version

Valid values[ "Unreleased", "Released", "ApprovalPending" ]
ValidFrom
string (date-time)

Valid from date of the playlist version

Example2023-01-25T09:08:03.747Z
ValidTo
string (date-time)

Valid to date of the playlist version

Example2023-01-25T09:08:03.747Z
Created
string (date-time)

Creation date in UTC

Id
integer (int32)

Unique ID of playlist

Modified
string (date-time)

Modification date in UTC

Name
string

Name of playlist

Permissions
object

Permissions of the playlist

property*
object additionalProperties

A set containing multiple entries containing one user group and its available permissions

Read
boolean
Write
boolean
CopyContent
boolean
Approve
boolean
VideoExport
boolean
ReceiveMessage
boolean
Tags
Array of object (V1.Models.Playlist.Tag)

Tags of the playlist

object

Playlist tag

Created
string (date-time)

Creation date in UTC

Id
integer (int32)

Unique ID of the tag

Modified
string (date-time)

Modification date in UTC

Name
string

Name of the tag

ParentId
integer (int32)

Unique ID of the parent tag

Permissions
object

Permissions of the tag

Read
boolean
Write
boolean
Type
string

Tag types

Valid values[ "Standard", "LiveTag", "SyncTag", "ConflictTag", "StartOfCommunication" ]
Versions
Array of object (V1.Models.Playlist.Version)

Playlist versions of the playlist

object

Playlist version

Id
integer (int32)

Unique ID of the playlist version

Name
string

Name of the playlist version

PlaylistId
integer (int32)

Playlist ID of the playlist version

Status
string

Status of playlist version

Valid values[ "Unreleased", "Released", "ApprovalPending" ]
ValidFrom
string (date-time)

Valid from date of the playlist version

Example2023-01-25T09:08:03.747Z
ValidTo
string (date-time)

Valid to date of the playlist version

Example2023-01-25T09:08:03.747Z
400

Bad request

Expand All
object
ValidationErrors
object
property*
Array of string additionalProperties
string
401

Unauthorized

Expand All
object
Id
string
Message
string
Type
string
Values
object
property*
object additionalProperties
403

Forbidden

Expand All
object
Id
string
Message
string
Type
string
Values
object
property*
object additionalProperties
404

Playlist not found.

Expand All
object
Id
string
Message
string
Type
string
Values
object
property*
object additionalProperties
500

Unexpected error

Expand All
object
Id
string
Message
string
Type
string
Values
object
property*
object additionalProperties