Skip to main content
POST
Upload media file or URL

Authorizations

X-API-Key
string
header
required

API key for authentication. Obtain from your team admin.

Example: X-API-Key: vsk_abc123def456ghi789jkl012mno345pqr678stu901vwx234yz

Body

input
Upload from URL · object
required

Response

Media uploaded successfully

media_id
string<uuid>

Unique identifier for the uploaded media

status
enum<string>

Upload status

Available options:
created,
existing,
pending_upload
duration_seconds
number | null

Video duration in seconds

frame_rate
number | null

Video frame rate (fps)

upload_url
string<uri> | null

Signed PUT URL returned for signed_url uploads

gcs_path
string | null

Storage path associated with the uploaded media

content_type
string | null

Content-Type associated with a signed upload