Skip to main contentIBM Video Streaming Developers

Create and manage playlists

Create a playlist

Create a new video playlist on a channel.

POST https://api.video.ibm.com/channels/{channel_id}/playlists.json

Parameters

The parameters for the POST request:

PARAMETERTYPEIMPORTANCEDESCRIPTION
titlestringREQUIREDTitle of the playlist
is_enabledintegerOPTIONALSupported values: 1 (enabled), 0 (disabled). Value is 1 by default.

Example:

POST playlists.json HTTP/1.1
Host: api.video.ibm.com
Authorization: Bearer ###TOKEN###
Content-Type: application/x-www-form-urlencoded
title=API+Testing+Playlist&is_enabled=1

Success response

Upon success, a response with HTTP status “201 Created” is returned. The response will contain the following headers:

HEADERTYPEDESCRIPTION
LocationstringThe URL of the new playlist

Error responses

Possible error responses:

HTTP RESPONSE CODEERROR VALUEERROR CONDITIONS
400 Bad Requestbad_requestThe playlist title is missing
401 Unauthorizedinvalid_tokenThe provided access token is missing, revoked, expired or malformed
403 Forbiddenlack_of_ownershipThe API user is not allowed to manage the given channel
404 Not Foundnot_foundChannel was not found
503Service Unavailable

There is a temporary error on the server which makes it impossible to serve the request

Modify a playlist

Change the title of an existing video playlist.

PUT https://api.video.ibm.com/playlists/{playlist_id}.json

Parameters

The parameters for the GET request:

PARAMETERTYPEIMPORTANCEDESCRIPTION
titlestringREQUIREDThe new title of the playlist

Success response

Upon success a response with HTTP status “200 OK” is returned.

Error responses

Possible error responses:

HTTP RESPONSE CODEERROR VALUEERROR CONDITIONS
400 Bad Requestbad_requestThe playlist title is missing
401 Unauthorizedinvalid_tokenThe provided access token is missing, revoked, expired or malformed
403 Forbiddenlack_of_ownershipThe API user is not allowed to manage the given channel
404 Not Foundnot_foundPlaylist was not found
503 Service UnavailableThere is a temporary error on the server which makes it impossible to serve the request

Delete a playlist

Delete an existing video playlist.

DELETE https://api.video.ibm.com/playlists/{playlist_id}.json

Parameters

This request has no parameters.

Success response

Upon success a response with HTTP status “200 OK” is returned.

Error responses

Possible error responses:

HTTP RESPONSE CODEERROR VALUEERROR CONDITIONS
401 Unauthorizedinvalid_tokenThe provided access token is missing, revoked, expired or malformed
403 Forbiddenlack_of_ownershipThe API user is not allowed to manage the given channel
404 Not Foundnot_foundPlaylist was not found
503 Service UnavailableThere is a temporary error on the server which makes it impossible to serve the request