Endpoints
Sign a reference upload
Was this page helpful?
Create a signed PUT target for larger Cinema reference media.
POST
/api/v1/uploads/sign
Create a signed reference-media upload
Create a two-hour signed staging PUT target for JPG, PNG, WebP, MP4, MP3, or WAV. The staging id cannot be used as a reference until uploads/verify succeeds; unverified objects are removed within the hourly sweep interval after expiry. The returned headers object is empty; do not forward a caller-chosen Content-Type. Shares the upload rate limit.
Authentication: Bearer API key required
curl -X POST "https://reviral.ai/api/v1/uploads/sign" \
-H "Authorization: Bearer $REVIRAL_API_KEY"Request body
| Field | Type | Required | Description |
|---|---|---|---|
| kind | string: image | video | audio | Yes | — |
| contentType | string: image/jpeg | image/png | image/webp | video/mp4 | audio/mpeg | audio/wav | Yes | — |
| bytes | integer (min 1, max 67108864) | Yes | — |
| filename | string | Yes | — |
Responses
- 200
- Signed PUT target
- 401
- Key is missing, revoked, or invalid
- 413
- Settings are invalid or a reference field is unsupported
- 415
- Settings are invalid or a reference field is unsupported
- 422
- Settings are invalid or a reference field is unsupported
- 429
- Too many requests