library. subtitles

Subtitle tracks parsed from WebVTT files. A media holds any number of languages and any number of versions per language; exactly one version per language is active, the one the player shows and AI AutoCut uses.

To add subtitles, upload the .vtt file as an asset (mimeType: text/vtt), confirm it, then POST /api/v1/library/media/{id}/subtitles with its assetId and language.

📄️List the subtitle tracks of a media

List the subtitle tracks of a media

📄️Create a subtitle track from an uploaded WebVTT file

Parses a confirmed SUBTITLE asset of the media into a track. The new track becomes the active one of its language, with the next version number. Upload the file first: POST /api/v1/library/media/{id}/assets with mimeType text/vtt, PUT the file, then POST /api/v1/library/assets/{id}/confirm.

📄️Retrieve a subtitle track

Retrieve a subtitle track

📄️Delete a subtitle track and its file

Deleting the active track makes the newest remaining version of the language active.

📄️Read the cues of a subtitle track

Read the cues of a subtitle track

📄️Make a subtitle track the active one of its language

Use it when an older version is the approved one. The previously active track of the language is deactivated.