Skip to main content
PUT
Add or replace a caption track

Authorizations

Authorization
string
header
required

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

Path Parameters

video
integer
required

The video's numeric ID.

lang
string
required

The language code for this track, e.g. en or es. Not validated against a fixed list: whatever you send is what viewers see as the track's key.

Body

application/json
label
string
required

The display label shown in the player's caption menu, e.g. English.

Maximum string length: 64
src
string
required

Either a URL to a WebVTT file, or raw WebVTT text.

Maximum string length: 8192
default
boolean

Selects this track by default when the player loads. Defaults to false.

Response

The video's full caption track list, including the track you wrote.

captions
object