Upload Video

Learn how to upload brand videos to your workspace

Overview#

This endpoint allows you to upload brand videos to your workspace. You can upload videos from a URL, as a base64-encoded string, or as a binary upload.

https://api.orshot.com/v1/brand-assets/videos/add

Request#

await fetch("https://api.orshot.com/v1/brand-assets/videos/add", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: "Bearer <ORSHOT_API_KEY>",
  },
  body: JSON.stringify({
    file: "https://example.com/videos/brand-intro.mp4",
    name: "brand-intro.mp4", // optional
    tags: ["intro", "brand"], // optional
    metadata: { // optional
      description: "Brand introduction video",
      category: "marketing"
    }
  }),
});

Request Parameters#

Parameter	Type	Required	Description
`file`	String	Yes	URL, base64-encoded string, or binary upload of the video file
`name`	String	No	Custom name for the video (defaults to original filename or auto-generated)
`tags`	String[]	No	Array of tags to associate with the video (e.g., `["intro", "brand"]`)
`metadata`	Object	No	Custom metadata to attach to the video (can include `width`, `height`, `duration`)