Multipart Uploads
Create Multipart Upload
Initialize a multipart upload for large files
POST
Overview
Initiates a multipart upload for files ≥ 5MB (5,242,880 bytes). Returns anuploadId and key that must be used for all subsequent operations.
Multipart Upload Flow:
- Create - Initialize the upload (this endpoint)
- Sign - Get presigned URLs for each part
- Upload - PUT each part to its URL
- Complete - Finalize the upload
- 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.

