--- title: "Create a video object" method: POST path: "/videos" tags: ["Videos"] --- # Create a video object `POST /videos` Creates a video object. More information on video objects can be found [here](https://docs.api.video/reference/api/Videos). ## Request body - VideoCreationPayload - `title` string, required — The title of your new video. - `description` string — A brief description of your video. - `source` string — You can either add a video already on the web, by entering the URL of the video, or you can also enter the `videoId` of one of the videos you already have on your api.video acccount, and this will generate a copy of your video. Creating a copy of a video can be especially useful if you want to keep your original video and trim or apply a watermark onto the copy you would create. - `public` boolean — Default: True. If set to `false` the video will become private. More information on private videos can be found [here](https://docs.api.video/delivery-analytics/video-privacy-access-management) - `panoramic` boolean — Indicates if your video is a 360/immersive video. - `mp4Support` boolean — Enables mp4 version in addition to streamed version. - `playerId` string — The unique identification number for your video player. - `tags` string[] — A list of tags you want to use to describe your video. - `metadata` Metadata[] — A list of key value pairs that you use to provide metadata for your video. These pairs can be made dynamic, allowing you to segment your audience. Read more on [dynamic metadata](https://api.video/blog/endpoints/dynamic-metadata/). - `key` string — The constant that defines the data set. - `value` string — A variable which belongs to the data set. - `clip` VideoClip — Use this object to create a smaller clip from a video you upload. - You can only create video clips in the same request where you create the video container. - You cannot update the starting or ending timestamps of a video clip after you created the video container. - When you upload a video file into a container where you defined a starting and ending timestamp, the API trims the video according to those timestamps to create a clip. - `startTimecode` string — The timestamp that defines the beginning of the video clip you want to create. The value must follow the `HH:MM:SS` format. - `endTimecode` string — The timestamp that defines the end of the video clip you want to create. The value must follow the `HH:MM:SS` format. - `watermark` VideoWatermark - `id` string — id of the watermark - `top` string — Distance expressed in px or % between the top-border of the video and the watermark-image. - `left` string — Distance expressed in px or % between the left-border of the video and the watermark-image. - `bottom` string — Distance expressed in px or % between the bottom-border of the video and the watermark-image. - `right` string — Distance expressed in px or % between the right-border of the video and the watermark-image. - `width` string — Width of the watermark-image relative to the video if expressed in %. Otherwise a fixed width. NOTE: To keep intrinsic watermark-image width use `initial`. - `height` string — Height of the watermark-image relative to the video if expressed in %. Otherwise a fixed height. NOTE: To keep intrinsic watermark-image height use `initial`. - `opacity` string — Opacity expressed in % only to specify the degree of the watermark-image transparency with the video. ## Response `201` Created - Video - `videoId` string, required — The unique identifier of the video object. - `createdAt` string, date-time — When a video was created, presented in ISO-8601 format. - `title` string — The title of the video content. - `description` string — A description for the video content. - `publishedAt` string, date-time — The date and time the API created the video. Date and time are provided using ISO-8601 UTC format. - `updatedAt` string, date-time — The date and time the video was updated. Date and time are provided using ISO-8601 UTC format. - `tags` string[] — One array of tags (each tag is a string) in order to categorize a video. Tags may include spaces. - `metadata` Metadata[] — Metadata you can use to categorise and filter videos. Metadata is a list of dictionaries, where each dictionary represents a key value pair for categorising a video. [Dynamic Metadata](https://api.video/blog/endpoints/dynamic-metadata/) allows you to define a key that allows any value pair. - `key` string — The constant that defines the data set. - `value` string — A variable which belongs to the data set. - `source` VideoSource — Source information about the video. - `uri` string — The URL where the video is stored. - `type` string - `liveStream` VideoSourceLiveStream — This appears if the video is from a Live Record. - `liveStreamId` string — The unique identifier for the live stream. - `links` VideoSourceLiveStreamLink[] - `rel` string - `uri` string - `assets` VideoAssets — Collection of details about the video object that you can use to work with the video object. - `hls` string, uri — This is the manifest URL. For HTTP Live Streaming (HLS), when a HLS video stream is initiated, the first file to download is the manifest. This file has the extension M3U8, and provides the video player with information about the various bitrates available for streaming. - `iframe` string — Code to use video from a third party website - `player` string, uri — Raw url of the player. - `thumbnail` string, uri — Poster of the video. - `mp4` string, uri — Available only if mp4Support is enabled. Raw mp4 url. - `playerId` string — The id of the player that will be applied on the video. - `public` boolean — Defines if the content is publicly reachable or if a unique token is needed for each play session. Default is true. Tutorials on [private videos](https://api.video/blog/endpoints/private-videos/). - `panoramic` boolean — Defines if video is panoramic. - `mp4Support` boolean — This lets you know whether mp4 is supported. If enabled, an mp4 URL will be provided in the response for the video. ## Other responses - `202` — Accepted - `400` — Bad Request - `429` — Too Many Requests ## Changes - **2024-04-16** `ec2b79bfdc8d` — 1 info - added the non-success response with the status `429` - **2022-04-28** `f9532dd3578c` — 2 info - the endpoint scheme security `apiKey` was added to the API - the endpoint scheme security `bearerAuth` was removed from the API - **2022-02-07** `2a4d90a64f88` — 2 breaking, 23 warning, 3 info - the `publishedAt` response's property format changed from `date-time` to no format for status `201` - the `publishedAt` response's property format changed from `date-time` to no format for status `202` - the optional response header `X-RateLimit-Limit` removed for the status `201` - the optional response header `X-RateLimit-Limit` removed for the status `202` - …24 more [Change history](https://skmtc.dev/apivideo/apis/api-video/changes/videos/post.md) --- [API](https://skmtc.dev/apivideo/apis/api-video.md) · [All operations](https://skmtc.dev/apivideo/apis/api-video/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/apivideo/api-video/revisions/ec2b79bfdc8d/schema)