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

idstring uuid required
Example:6f1c2d6e-3b1a-4c0f-9a0e-2f5d1c7b8e90

Clip id (UUID)

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.

Which edit/export: vertical (9:16, default), horizontal (16:9), square (1:1) or portrait45 (4:5). Each clip has one independent edit per orientation.

Response

B-roll list

idstring required
startnumber required
endnumber required
src'pexels' | 'upload' required
pathstring required

Server path under data/broll/ (send back unchanged)

preview_urlstring nullable
querystring nullable

Changes

No recorded changes to this operation across all 1 revision of this API.