Sign in

v32

latestOpenAPI 3.1.0raw.githubusercontent.com2026-05-151,1412,2144.5 MB
Subtitles

Change subtitle

Method to update subtitle of a video.

You can update all or only some of fields you need.

If you want to replace the text of subtitles (i.e. found a typo in the text, or the timing in the video changed), then:

  • download it using GET method,
  • change it in an external editor,
  • and update it using this PATCH method.

Just like videos, subtitles are cached, so it takes time to update the data. See POST method for details.

patch/streaming/videos/{video_id}/subtitles/{id}

Path parameters

idinteger required

ID of a subtitle

video_idinteger required

ID of a video

Request body

namestring

Name of subtitle file

languagestring

3-letter language code according to ISO-639-2 (bibliographic code)

vttstring

Full text of subtitles/captions, with escaped "\n" ("\r") symbol of new line

Example request

{
  "language": "ltz"
}

Response

Successful

namestring

Name of subtitle file

languagestring

3-letter language code according to ISO-639-2 (bibliographic code)

vttstring

Full text of subtitles/captions, with escaped "\n" ("\r") symbol of new line

Example response

{
  "name": "German (AI-generated)",
  "language": "ltz",
  "vtt": "WEBVTT\n\n1\n00:00:07.154 --> 00:00:12.736\nWir haben 100 Millionen registrierte Benutzer oder aktive Benutzer, die mindestens einmal pro Woche spielen.\n\n2\n00:00:13.236 --> 00:00:20.198\nWir haben vielleicht 80 oder 100.000, die auf einem bestimmten Cluster spielen."
}