Videos

Apply a subtitle preset

Apply a preset returned by GET /v1/subtitle-presets. Built-in presets restore style, font, weight, and size, preserving position, grouping, and lines per block. Personal presets also restore those saved layout settings. Does not change transcript text or whether subtitles are enabled. Changes sync to open editors; reapplying the same preset is safe.

put/v1/videos/{id}/subtitle-preset

Path parameters

idstring required

Unique video identifier

Example:vid_abc123def456

Unique video identifier

Request body

presetIdstring required

Example request

{
  "presetId": "default:spotlight"
}

Response

Preset applied

Example response

{
  "preset": {
    "captionStyle": {
      "activeWordTextColor": "#5E51F8FF",
      "backgroundColor": "#5E51F8FF",
      "highlightColor": "#5E51F8FF",
      "outlineColor": "#5E51F8FF",
      "shadowColor": "#5E51F8FF",
      "textColor": "#5E51F8FF"
    },
    "presetId": "default:spotlight"
  }
}

Changes

Changed in 2 of the 18 revisions of this API.91

Sep 28, 2026ac47c99c144f9See the full diff
- ●
  added the new edit_conflict enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new edit_conflict enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new edit_conflict enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new edit_conflict enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new edit_conflict enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new edit_conflict enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new edit_conflict enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new edit_conflict enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new edit_conflict enum value to the response property for the response status
  response-property-enum-value-added
Sep 12, 2026955068d95b7e1See the full diff
- ○
  endpoint added
  endpoint-added

Of the 18 revisions, 1 has no diff computed.

Full history