Skip to main content
POST
Create an upload

Authorizations

Authorization
string
header
required

An API key from the web app (Settings → Developer), sent as Authorization: Bearer rvl_live_….

Body

application/json
name
string
required
Required string length: 1 - 200
sizeBytes
integer
required
Required range: x <= 104857600
contentType
string
default:application/octet-stream
Maximum string length: 100

Response

OK

id
string
required

File id, file_….

name
string
required

The stored name, with unsafe characters replaced.

status
string
required
Allowed value: "pending_upload"
upload
object
required

PUT the file bytes to url with headers before expiresAt. The file is usable once GET /v1/files/{fileId} returns it.