Replace playlist content and order with a stringified JSON content array.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Replace the full content of a playlist (VOD and/or channel items) and their order.
This is a full replace, not a delta. Every PUT must send the complete list you want after the change. To add an item, include existing items plus the new one. To remove an item, omit it. To reorder, send the same ids with new position values.
A VOD should be online (online: true on GET /v2/vod/{id}) before you add it. Membership is eventually consistent: the PUT response may return content.list: null even on 200; poll GET /v2/playlists/{playlist_id} until the items appear.
Path parameter
| Name | Type | Description |
|---|---|---|
playlist_id | string (UUID) | Required. The playlist identifier. |
Request body
Send JSON with Content-Type: application/json. The content field must be a string containing a JSON array (not a raw array).
| Field | Type | Description |
|---|---|---|
content | string | Stringified JSON array of items. Each item: id (UUID), type (vod or channel), position (1-based integer). Send the full desired list, including order. |
Example request body:
{
"content": "[{\"id\":\"3c7a4c4c-163b-49b1-987e-2b2d139fda64\",\"type\":\"vod\",\"position\":1},{\"id\":\"6cb5f0ed-13eb-8d86-da0e-fc95db7837ad\",\"type\":\"vod\",\"position\":2}]"
}Response
| Code | Meaning |
|---|---|
| 200 | Accepted. Returns the playlist object. content.list may be null immediately; confirm with lookup. |
After a successfulPUT, pollGET /v2/playlists/{playlist_id}untilcontent.listcontains the expected items. Do not assume thePUTbody already reflects membership.📘
positionvalues in responses are often returned as strings (e.g."1"), even when you send them as numbers.