Sign in

v2

latestOpenAPI 3.1.02026-08-013435189.7 KB
uploads

Create an upload

Creates an upload record for a direct single-PUT transfer. Next, request a presigned URL with POST /uploads/{id}/upload-url, PUT the bytes to it, then mark the upload complete with POST /uploads/{id}/complete.

post/uploads

Headers

Idempotency-Keystring

Optional client-generated key. A repeated request with the same key replays the original response (within 24h) instead of re-executing — safe retries.

Request body

durationinteger nullable
fileSizeinteger nullable
fpsnumber nullable
hasAudioboolean nullable
hasVideoboolean nullable
heightinteger nullable
isDeletedboolean nullable
mimeTypestring required
namestring required
orientationinteger nullable
pathstring nullable
type'audio' | 'video' | 'image' required
widthinteger nullable

Response

Created.

createdAtstring date-time required
fileSizeinteger nullable
idstring required
mimeTypestring required
namestring required
type'audio' | 'video' | 'image' required
uploadedboolean required