Skip to main content
DELETE
Remove 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.

Response

The playlist's remaining items.

items
object[]
total
integer

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