v50

latestOpenAPI 3.0.1MITraw.githubusercontent.com2026-06-15222761.9 KB

Upload an asset

Upload an image or video asset by providing a publicly accessible URL. The asset is downloaded and processed asynchronously.

Poll GET /assets/{id} until status is READY before using the asset as B-roll in a video.

Size limits: 50 MB for images, 2 GB for videos.

Accepted formats: JPEG, PNG, GIF, WEBP, AVIF for images. MP4, MOV for videos.

Concurrent limit: Maximum 5 assets processing at a time per workspace.

post/assets

namestring required

Display name for the asset

type'IMAGE' | 'VIDEO' required

Asset type. Audio upload is not supported.

urlstring uri required

Publicly accessible URL to download the asset from

Duplicate asset found — existing asset returned

idstring uuid

namestring nullable

type'AUDIO' | 'IMAGE' | 'VIDEO'

status'PROCESSING' | 'READY' | 'FAILED'

Processing status. Poll until READY before using as B-roll.

fileUrlstring nullable

URL to access the asset. Null while processing.

thumbnailUrlstring nullable

URL to a thumbnail image. Null while processing.

createdAtstring date-time