Update a video

Partially update a video (PATCH). Send only fields to change;
omitted fields stay unchanged. Updates return 204 No Content.
Requires video.manage
scope.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
📘

You are reading API v2 documentation

Still using the Legacy API? Access the Legacy API documentation.



Path Params
string
required
Body Params
string
length between 1 and 255
(?:\S+\s*)+

Video title shown in the player and catalog. Must be at least 1 characters. Must be at most 255 characters. Must match pattern: (?:\S+\s*)+.

length ≤ 3000
(?:\S+\s*)+

Short or long description; HTML allowed where configured. Leading and trailing whitespace is trimmed. Must be at most 3000 characters. Must match pattern: (?:\S+\s*)+. Accepts HTML content.

string
enum

Content category used for discovery and reporting. Required on create.

string
enum

Who can watch the video (public, private, or password).

Allowed:
boolean

Whether the video is made for kids (COPPA). Required on create. Strict type checking (no coercion).

boolean

Whether the video is explicit.
Warning This flag cannot be removed once set. Strict type checking (no coercion).

length between 1 and 32

Password for the video. Writable. Must be at least 1 characters. Must be at most 32 characters. Required when visibility is password. Only allowed when visibility is password.

ISO 8601 timestamp when the video was published.

^[a-zA-Z]{2}$

ISO 639-1 language code (e.g. en, fr). Must match pattern: ^[a-zA-Z]{2}$.

^[a-zA-Z]{2}$

ISO 3166-1 alpha-2 country code (e.g. US, FR). Must match pattern: ^[a-zA-Z]{2}$.

length ≤ 500
(?:[\S]+[\s]*)+

Engagement message associated with the video. Must be at most 500 characters. Must match pattern: (?:[\S]+[\s]*)+.

hashtags
array of strings

Hashtags associated with the video.

Hashtags
tags
array of strings

Tags associated with the video.

Tags
boolean

Whether the video content was altered with AI. Strict type checking (no coercion).

ai_subtitles
array of strings

Languages available for AI-generated subtitles.

Ai Subtitles
boolean

Whether AI chapter generation is enabled. Strict type checking (no coercion).

embedding
object

Embed settings for this video (URLs and HTML snippet).

geo_restriction
object

Embedded object for video geo restriction fields.

source
object

Source media metadata and optional ingest URL for create/replace.

Responses
204

Successful Response

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json