Upload an asset
Assets
Upload Asset
Upload an image or video asset via URL for use as B-roll
POST
Upload an asset
Upload an image or video by providing a publicly accessible URL. The asset is downloaded and processed asynchronously.
Usage Flow
- Call
POST /assetswith the asset URL, name, and type - Receive the asset ID with
status: PROCESSING - Poll
GET /assets/{id}untilstatusisREADY - Use the asset ID in
POST /videoswithbroll.type: UPLOAD
Example
Authorizations
API key to be included in the x-api-key header
Body
application/json
Response
Duplicate asset found — existing asset returned
Available options:
AUDIO, IMAGE, VIDEO Processing status. Poll until READY before using as B-roll.
Available options:
PROCESSING, READY, FAILED URL to access the asset. Null while processing.
URL to a thumbnail image. Null while processing.
