Skip to main content
PATCH
PATCH /playlists/{id}
Required permissions: playlists.update. Send an Idempotency-Key for this change. It is an operation ID, not an API key. Generate a UUID and reuse it when retrying the same request.
Use your Platform API key in Postman or your backend. Keep it private; do not enter it in this public page. Your workspace permissions and plan limits apply.
See the quickstart for request examples. Required fields and responses are listed below.

Authorizations

Authorization
string
header
required

Platform API key for one workspace. Create it in Settings with an expiry date or Never expire. Keep it private; use it from Postman or your backend, not browser code. Widget keys are not accepted.

Headers

Idempotency-Key
string
required

An operation ID, not your API key. Generate a UUID for each new change and reuse it when retrying the same request. See https://docs.layarva.com/developers/platform-request-keys for Postman, PowerShell and Node.js examples. Upload instructions are refreshed when requested again.

Pattern: ^[A-Za-z0-9._:-]{1,128}$

Path Parameters

id
string
required
Pattern: ^[A-Za-z0-9_-]{1,100}$

Body

application/json

Send application/json using the fields below. JSON requests must be no larger than 64 KiB.

Source references resolve from owned live assets/designs, not URLs or caller metadata. Up to 100 items; durations may be increased to authoritative media minimum. Source URL/manifest/Widget secrets not accepted. NONE transition requires duration 0; other transitions 100–5000ms; SLIDE/PUSH/WIPE require direction; DIP_TO_COLOR requires color. PATCH needs expectedDraftRevision and at least one editable field.

expectedDraftRevision
integer
required
Required range: 0 <= x <= 2147483647
name
string
Required string length: 1 - 120
description
string
Maximum string length: 500
items
object[]
Maximum array length: 100
defaultTransition
object

Response

Safe live-authorized result

data
object
required