Skip to main content
PATCH
Update a playlist item

Authorizations

Authorization
string
header
required

A scoped token minted in Settings → API tokens. Send it as Authorization: Bearer tplt_… or X-API-Key: tplt_….

Headers

Idempotency-Key
string

Retry-safe key. The first response for a given key is cached for 24 hours and replayed on a repeat, with Idempotency-Replayed: true set.

Path Parameters

playlist
integer
required

The numeric ID of the video the playlist lives on. A playlist has no ID of its own: it is settings stored on a video row, so this is that video's id, the same value you would pass to GET /videos/{video}.

video
string
required

Despite the parameter name, this is the item's video_code, not a numeric ID. Playlist items are addressed by video code, because a playlist item has no ID of its own either.

Body

application/json

Every field is optional. Send only what you want to change.

title
string
Maximum string length: 255
lesson_label
string
Maximum string length: 255
duration_s
integer
Required range: x >= 0
thumb_url
string<uri>
Maximum string length: 2048

Response

The playlist's full item list.

items
object[]
total
integer

Only present on GET /playlists/{playlist}/videos.