Skip to main content
POST
/
s3
/
multipart
/
create
curl -X POST https://app.drime.cloud/api/v1/s3/multipart/create \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "filename": "large-video.mp4",
    "mime": "video/mp4",
    "size": 142557981,
    "extension": "mp4",
    "workspaceId": 0
  }'

{
  "key": "uploads/1e4cbca8-165f-4780-9cb7-fc4d8f2e4834/1e4cbca8-165f-4780-9cb7-fc4d8f2e4834",
  "uploadId": "AFNhWKh6Cn6fOryIGSCF4GFVTXB1CnOpdipc0ZHJIHwk9YBgHjLXwXhQkzQ4LmXVkW46cl1ICuQFI4KPBWXt...",
  "acl": "private",
  "status": "success"
}

​
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

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

​
Response

​
key
string
S3 key for the upload
​
uploadId
string
Multipart upload ID (required for all subsequent operations)
​
acl
string
Access control (private)
​
status
string
Request status (success)
curl -X POST https://app.drime.cloud/api/v1/s3/multipart/create \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "filename": "large-video.mp4",
    "mime": "video/mp4",
    "size": 142557981,
    "extension": "mp4",
    "workspaceId": 0
  }'

{
  "key": "uploads/1e4cbca8-165f-4780-9cb7-fc4d8f2e4834/1e4cbca8-165f-4780-9cb7-fc4d8f2e4834",
  "uploadId": "AFNhWKh6Cn6fOryIGSCF4GFVTXB1CnOpdipc0ZHJIHwk9YBgHjLXwXhQkzQ4LmXVkW46cl1ICuQFI4KPBWXt...",
  "acl": "private",
  "status": "success"
}
Each part should be ~5MB (5,242,880 bytes) except for the last part which may be smaller.