Files
Create a file (presigned upload)
Create a file record and get a presigned URL to upload the bytes directly to storage.
Flow:
- Compute the file’s SHA-256 hash and base64-encode it.
- Call this endpoint with the filename, MIME type, size, and checksum. You receive a
fileIdand a presigneduploadUrl. PUTthe raw bytes touploadUrlwith headersContent-Type: <mimeType>andx-amz-checksum-sha256: <checksum>. S3 verifies the checksum on write.- (Recommended) Call
POST /api/v1/files/:id/confirmto verify the upload and flip the record toCONFIRMEDimmediately. Otherwise it is confirmed automatically the first time it is fetched viaGET /api/v1/files/:id.
Why: the bytes go straight to storage, so there is no API-server size limit.
POST
Create a file (presigned upload)
Authorizations
Headers
Body
application/json
Body
Request a presigned upload URL and create a pending file record
MIME type of the file
Available options:
application/pdf, application/msword, application/vnd.openxmlformats-officedocument.wordprocessingml.document, application/vnd.ms-excel, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet, application/vnd.ms-powerpoint, application/vnd.openxmlformats-officedocument.presentationml.presentation, video/mp4, video/quicktime, video/x-msvideo, video/webm, image/jpeg, image/png, image/gif, image/webp, image/svg+xml Response
Presigned upload details
Presigned upload details
Create a file (presigned upload)

