Skip to main content
PATCH
/
streaming
/
playlists
/
v1
/
{playlist_id}
cURL
curl --request PATCH \
  --url https://api.mottostreaming.com/streaming/playlists/v1/{playlist_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "dvr_settings": {
    "window_size_seconds": 123
  },
  "visibility": "VISIBILITY_UNSPECIFIED",
  "visibility_markers": [
    {
      "type": "VISIBILITY_MARKER_TYPE_UNSPECIFIED",
      "offset": "<string>",
      "priority": "<string>"
    }
  ]
}
'
{
  "playlist": {
    "id": "<string>",
    "name": "<string>",
    "format": "PLAYLIST_FORMAT_UNSPECIFIED",
    "private_url": "<string>",
    "public_url": "<string>",
    "dvr_settings": {
      "window_size_seconds": 123
    },
    "visibility": "VISIBILITY_UNSPECIFIED",
    "org_id": "<string>",
    "project_id": "<string>",
    "video_id": "<string>",
    "visibility_markers": [
      {
        "type": "VISIBILITY_MARKER_TYPE_UNSPECIFIED",
        "offset": "<string>",
        "priority": "<string>"
      }
    ]
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
playlist_id
string
required

Query Parameters

​
update_mask
string<field-mask>

Body

application/json
​
name
string

The name of the playlist. For example: "Raw" or "playlist 1"

​
dvr_settings
object
​
visibility
enum<string>

The visibility of the playlist. This affects the entire playlist. Individual segments can still be made invisible using VisibilityMarkers.

Available options:
VISIBILITY_UNSPECIFIED,
VISIBILITY_PUBLISHED,
VISIBILITY_UNLISTED,
VISIBILITY_HIDDEN
​
visibility_markers
object[]

Optional. A list of visibility markers that define which parts of the playlist are visible to end users. If no markers are defined, all segments are considered visible (as long as the overall playlist visibility allows it). Example: Assume your playlist has a total duration of 600 seconds, and you define the following markers:

  1. Start Publish, offset 120
  2. End Publish, offset 480 This would mean that segments from 0 to 120 seconds are not visible, segments from 120 to 480 seconds are visible, and segments from 480 to 600 seconds are not visible.

Note: The offset is relative to the start of the playlist, not the absolute time. Note 2: Offsets that do not align with segment boundaries will be floored to the last segment end time. In the above example, if segments are 6 seconds long, and you set a Start Publish marker at offset 123, it will be treated as offset 120.

Response

OK

​
playlist
object