Skip to main content
PATCH
Update a video

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

video
integer
required

The video's numeric ID.

Body

application/json

Every field is optional. Send only what you want to change.

title
string
Maximum string length: 255
folder_id
integer | null

A folder of this workspace (anything else is 422 FOLDER_NOT_FOUND), or null to move the video out of its folder.

tags
string[]
Maximum string length: 64

Response

The updated video.

video
object

A video and its settings. A video carries around thirty option-group columns (style, playback, autoplay, captions, chapters, CTA cards, playlist, and more) that are not itemized here. Read GET /videos/{video}/settings for the full set, or the dedicated endpoint for the group you care about (captions, chapters, AI segments, CTA cards).