Start a direct binary upload

For files you have as bytes rather than at a public URL (and for large videos). Returns a presigned PUT URL: upload the raw file bytes to it with the exact Content-Type given, then call complete. The URL expires after an hour; plan quotas are checked against the declared size.

Authorization

api-key

AuthorizationBearer <token>

Workspace API key (nim_live_...)

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

fileName*string

File name (extension is used for typing)

contentType*string

MIME type of the file — must match the Content-Type header of the PUT

sizeBytes*number

File size in bytes (checked against plan quotas up front)

Response Body

`application/json`

curl -X POST "https://example.com/v1/media/uploads" \  -H "Content-Type: application/json" \  -d '{    "fileName": "launch-video.mp4",    "contentType": "video/mp4",    "sizeBytes": 10485760  }'

{  "mediaId": "string",  "uploadUrl": "string",  "method": "PUT",  "headers": {    "Content-Type": "video/mp4"  },  "expiresInSeconds": 3600}

Empty

Authorization

Request Body

Response Body

201application/json

400

`application/json`