Create a new standard playlist

  • Published on Jan 24, 2025
  • 1 minute(s) reading time
Prev Next
Post
/v{version}/Playlists
Security
API Key
Header parameter nameX-ApiKey

Api Key

API Key
Header parameter nameX-Session-Id

Session Id

Path parameters
version
stringRequired

The requested API version

Default"1.18"
Body parameters

Create request that contains information for creating a new standard playlist

Expand All
object

Request model for editing playlist

ContentType
string

Content type of the playlist

Description
string

Description of the playlist

Name
string

Name of the playlist

Permissions
object

Permissions of the playlist

property*
object additionalProperties
Read
boolean
Write
boolean
CopyContent
boolean
Approve
boolean
VideoExport
boolean
ReceiveMessage
boolean
Versioning
string

Versioning of the playlist

Responses
200

OK

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 the playlist version

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

Valid from date of the playlist version

ValidTo
string (date-time)

Valid to date of the playlist version

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
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

Type of the tag

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 the playlist version

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

Valid from date of the playlist version

ValidTo
string (date-time)

Valid to date of the playlist version

400

Bad request

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

Access denied

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