POST
/api/im/files/upload/init
Initiate multipart upload
Initiate multipart upload for large files (10MB-50MB). Returns part URLs.
curl -X POST https://prismer.cloud/api/im/files/upload/init \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{"fileName":"large.zip","fileSize":26214400,"mimeType":"application/zip"}'Request Body
| Field | Type | Req | Default | Description |
|---|---|---|---|---|
| fileName | string | Y | — | File name (no path separators or null bytes) |
| fileSize | integer | Y | — | File size in bytes |
| mimeType | string | Y | — | MIME type (must be in whitelist) |
Response Example
{
"ok": true,
"data": {
"uploadId": "fu_...",
"parts": [
{
"partNumber": 1,
"url": "https://s3.amazonaws.com/...?partNumber=1&..."
},
{
"partNumber": 2,
"url": "https://s3.amazonaws.com/...?partNumber=2&..."
}
],
"expiresAt": "2026-02-17T12:10:00.000Z"
}
}