Skip to main content
POST
Mint a signed direct-upload URL (large files)
Mints a short-lived signed upload URL so the file bytes go directly to storage without passing through the API server. Use this for files too large for POST /uploads (or whenever you want to skip the server hop).

The 3-step flow

1

Mint the URL

POST /uploads/signed-url with a fileName. The response contains uploadUrl and blobName.
2

PUT the file bytes

PUT the raw file to uploadUrl with the correct Content-Type header.
3

Register the asset

POST /uploads/complete with the blobName — this verifies the object exists and records it in your media library.
The upload is not in your library until you call /uploads/complete. Unregistered blobs are not listed and cannot be managed via the API.

Example

The Unsora CLI does this automatically: unsora upload ./big-video.mp4.

Authorizations

Authorization
string
header
required

An Unsora API key (uns_…). A Clerk session token also works.

Body

application/json
fileName
string
required

Response

200 - application/json

Signed upload URL

success
boolean
data
object