---
title: "Upload your own B-roll file (≤ 200 MB)"
method: POST
path: "/api/clips/{id}/broll/upload"
tags: ["enrich"]
---

# Upload your own B-roll file (≤ 200 MB)

`POST /api/clips/{id}/broll/upload`

## Request

- Base URL: `https://cliponit.app`
- URL: `https://cliponit.app/api/clips/{id}/broll/upload`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `session`
  - OAuth 2 (authorization code, authorization URL `https://cliponit.app/oauth/authorize`, token URL `https://cliponit.app/oauth/token`, scopes: `clips`)

## Path parameters

- `id` string, uuid, required

## Query parameters

- `orientation` 'vertical' | 'horizontal' | 'square' | 'portrait45': vertical = 9:16 1080x1920 (TikTok/Reels/Shorts), horizontal = 16:9 1920x1080 (YouTube), square = 1:1 1080x1080 (feed), portrait45 = 4:5 1080x1350 (Instagram feed). auto-reframe supports vertical|horizontal only.

## Response `200`

B-roll list

- Broll[]
  - `id` string, required
  - `start` number, required
  - `end` number, required
  - `src` 'pexels' | 'upload', required
  - `path` string, required: Server path under data/broll/ (send back unchanged)
  - `preview_url` string, nullable
  - `query` string, nullable

## Other responses

- `403`: Feature not included in the user's plan (upgrade at /billing)

---

[API](https://skmtc.dev/cliponit/apis/cliponit-api.md) · [All operations](https://skmtc.dev/cliponit/apis/cliponit-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cliponit/apis/cliponit-api/revisions/10e3e4327922?raw)