Create a video for a profile

Create a new video under this profile. Required body fields are
title, visibility, category, is_for_kids, and source
(use source.file_url for upload workflows). Returns 201 with the
created representation.
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

Parent resource ID

Body Params
string
required
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
required

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

string
enum
required

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

Allowed:
boolean
required

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

boolean
Defaults to false

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
Defaults to []

Hashtags associated with the video.

Hashtags
tags
array of strings
Defaults to []

Tags associated with the video.

Tags
boolean
Defaults to false

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

ai_subtitles
array of strings
Defaults to []

Languages available for AI-generated subtitles.

Ai Subtitles
boolean
Defaults to false

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
required

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

Responses

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