Skip to main content
POST
Create an upload

Authorizations

Authorization
string
header
required

Your secret key as a bearer token, e.g. Authorization: Bearer sk_live_…. Secret keys are server-side only.

Body

application/json
mimeType
string

Content type of the file you intend to upload.

sizeBytes
integer

Expected size in bytes. Capped at 500 MB.

Response

OK

fileRef
string

Pass this as a job source.

upload
object
maxBytes
integer
expiresIn
integer

Seconds until the credentials expire.