Skip to main content
POST
Get a single-use upload link (used without an authorization header)

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Response

Success

mediaId
string | null
required

Library id reserved for the upload.

uploadUrl
string<uri>
required

PUT the raw bytes here (no auth header).

uploadMethod
enum<string>
required
Available options:
PUT
direct
boolean
required

True when the upload goes straight to storage.

mediaUrl
string<uri>
required

Final URL of the file once uploaded.

uploadPageUrl
string<uri>
required

Same ticket as a browser drop page; chunks big files for a human.

expiresAt
string<date-time>
required
Example:

"2026-11-10T09:30:00.000Z"

maxBytes
integer
required
singlePutMaxBytes
integer
required

Ceiling of a single PUT to uploadUrl (lower than maxBytes).

multipartUrl
string<uri> | null
required

Chunked upload entry point, when the storage supports it.