Skip to main content
POST

Overview

Initiates a multipart upload for files ≥ 5MB (5,242,880 bytes). Returns an uploadId and key that must be used for all subsequent operations. Multipart Upload Flow:
  1. Create - Initialize the upload (this endpoint)
  2. Sign - Get presigned URLs for each part
  3. Upload - PUT each part to its URL
  4. Complete - Finalize the upload
  5. Register - Create file entry with /s3/entries

Request Body

string
required
Original filename
string
required
MIME type
integer
required
File size in bytes
string
required
File extension without dot
integer
Workspace ID
string
Folder path for auto-creation
integer
Parent folder ID

Response

string
S3 key for the upload
string
Multipart upload ID (required for all subsequent operations)
string
Access control (private)
string
Request status (success)
Each part should be ~5MB (5,242,880 bytes) except for the last part which may be smaller.