Update a playlist
PATCH/v2/game-plans/{gamePlanId}/playlists/{playlistId}
const url = 'https://api.ligr.live/rest/v2/game-plans/1/playlists/1';const options = { method: 'PATCH', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"name":"example","scope":"break","priority":1,"guard":["example"],"transitions":[{"id":"example","type":"action","name":"example","code":"example","offset":1,"desiredState":"example","graphicUuid":"example","transitionUuid":"example","hideTargetUuid":"example","controlVariables":"example","adFile":"example","multi":"example","loop":true,"duration":1,"groupVariant":"graphic","advertisementControlVariable":"example","children":[]}]}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request PATCH \ --url https://api.ligr.live/rest/v2/game-plans/1/playlists/1 \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "name": "example", "scope": "break", "priority": 1, "guard": [ "example" ], "transitions": [ { "id": "example", "type": "action", "name": "example", "code": "example", "offset": 1, "desiredState": "example", "graphicUuid": "example", "transitionUuid": "example", "hideTargetUuid": "example", "controlVariables": "example", "adFile": "example", "multi": "example", "loop": true, "duration": 1, "groupVariant": "graphic", "advertisementControlVariable": "example", "children": [] } ] }'Beta. This operation can change between minor versions. See Beta status.
Updates a playlist of a game plan. Omitted fields keep their stored value. transitions
replaces the whole list. The scope cannot change.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Entity identifier
Entity identifier
Request Bodyrequired
Section titled “Request Bodyrequired”Omitted fields keep their stored value. transitions replaces the whole list.
The scope cannot change: send the stored value or leave it out.
object
Null removes every guard.
One step of a playlist. The overlay runs the steps in offset order.
desiredState, controlVariables, adFile and multi are JSON that the dashboard writes for each
graphic, ad or media item. Their keys depend on the graphic, so LIGR stores them as sent. Read a
playlist that the dashboard built to see the keys for your graphics.
object
Unique inside the playlist. Use a UUID.
The label the dashboard shows.
For graphic, the graphic name. For action, the action, for example action:hideAll or
action:hide:<graphic code>.
Seconds after the playlist starts. Inside a group, seconds after the group starts.
What the step shows or hides, as a JSON object. A graphic step reads variableValues,
updateType (update or set) and guard, for example
{ "updateType": "update", "variableValues": { "StatOne": "shots" } }.
UUID of the graphic a graphic step shows.
Stable UUID that an action step names in hideTargetUuid.
transitionUuid of the step that this hide action removes.
The control variables of the graphic, as the dashboard stores them. An array of JSON objects.
The ad file of an advertisement step, as a JSON object.
The media item of a multimedia step, as a JSON object.
True when a group step repeats.
Seconds the step stays on screen.
The content type of a group step.
The control variable that a group step uses for its ads.
Responses
Section titled “Responses”Ok
A playlist of a game plan. A live playlist runs on live triggers. A break playlist runs on break triggers.
object
Entity identifier
1 is the highest priority.
One step of a playlist. The overlay runs the steps in offset order.
desiredState, controlVariables, adFile and multi are JSON that the dashboard writes for each
graphic, ad or media item. Their keys depend on the graphic, so LIGR stores them as sent. Read a
playlist that the dashboard built to see the keys for your graphics.
object
Unique inside the playlist. Use a UUID.
The label the dashboard shows.
For graphic, the graphic name. For action, the action, for example action:hideAll or
action:hide:<graphic code>.
Seconds after the playlist starts. Inside a group, seconds after the group starts.
What the step shows or hides, as a JSON object. A graphic step reads variableValues,
updateType (update or set) and guard, for example
{ "updateType": "update", "variableValues": { "StatOne": "shots" } }.
UUID of the graphic a graphic step shows.
Stable UUID that an action step names in hideTargetUuid.
transitionUuid of the step that this hide action removes.
The control variables of the graphic, as the dashboard stores them. An array of JSON objects.
The ad file of an advertisement step, as a JSON object.
The media item of a multimedia step, as a JSON object.
True when a group step repeats.
Seconds the step stays on screen.
The content type of a group step.
The control variable that a group step uses for its ads.
Position of the playlist in the plan. Null until the plan is reordered.
Example
{ "scope": "break", "transitions": [ { "type": "action", "groupVariant": "graphic" } ]}Request is invalid
object
object
Examplegenerated
{ "message": "example", "details": { "additionalProperty": "example" }}Missing or invalid api key
object
Examplegenerated
{ "message": "example"}Api key provides insufficient access for the request
object
Examplegenerated
{ "message": "example"}Game plan, theme, playlist or trigger not found
object
Examplegenerated
{ "message": "example"}Organization has made too many requests
object
Examplegenerated
{ "message": "example"}An unexpected error has occured. If problems persist please contact support
object
Examplegenerated
{ "message": "example"}