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
    metadata: { // optional
      description: "Brand introduction video",
      category: "marketing"
    }
  }),
});

Request Parameters#

ParameterTypeRequiredDescription
fileStringYesURL, base64-encoded string, or binary upload of the video file
nameStringNoCustom name for the video (defaults to original filename or auto-generated)
metadataObjectNoCustom metadata to attach to the video (can include width, height, duration)

Supported Video Formats#

  • MP4 (video/mp4)
  • WebM (video/webm)
  • QuickTime / MOV (video/quicktime)
  • AVI (video/x-msvideo)
  • Matroska / MKV (video/x-matroska)
  • FLV (video/x-flv)
  • WMV (video/x-ms-wmv)
  • M4V (video/x-m4v)
  • GIF (image/gif)

Notes#

  • Maximum file size: 60MB
  • Uploaded videos are stored as-is without transcoding

Rate Limits#

  • 30 requests per minute per endpoint

All Set? Let's Start Automating

Get Your API Key →
  • Image, PDF and Video Generation via API
  • Canva like editor with AI and smart features
  • No-Code Integrations (Zapier, Make, n8n etc.)
  • Embed Orshot Studio in your app
  • Start Free. No credit card required. Cancel anytime.