Skip to main content
POST
Add an item to a playlist

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}.

Body

application/json
video_code
string
required

The code of the video to add to the playlist. Required.

Maximum string length: 64
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, including the item you added.

items
object[]
total
integer

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