Uploads Guide - Drime Cloud API

Choosing the Right Method

Drime Cloud offers several upload methods depending on your file size:

Direct Upload

< 5 MB - Simple and fast via multipart/form-data

Presigned URL

< 5 MB - Direct upload to S3 with presigned URL

Multipart Upload

≥ 5 MB - For large files, upload in chunks

Simple Upload (< 5 MB)

For small files, use direct upload:

const formData = new FormData();
formData.append('file', file);
formData.append('workspaceId', '0');

const response = await fetch('https://app.drime.cloud/api/v1/uploads', {
  method: 'POST',
  headers: { 'Authorization': 'Bearer TOKEN' },
  body: formData
});

Presigned URL Upload (< 5 MB)

More performant, as it uploads directly to storage:

Get the presigned URL

const { url, key } = await fetch('/s3/simple/presign', {
  method: 'POST',
  body: JSON.stringify({ filename, mime, size, extension })
}).then(r => r.json());

Upload to S3

await fetch(url, { method: 'PUT', body: file });

await fetch('/s3/entries', {
  method: 'POST',
  body: JSON.stringify({ filename: key.split('/').pop(), size, clientName })
});

Multipart Upload (≥ 5 MB)

For large files, split into 5 MB chunks:

Initialize

Call /s3/multipart/create to get an uploadId

Sign URLs

Call /s3/multipart/batch-sign-part-urls for each part

Upload parts

PUT each chunk to its URL, collect the ETags

Complete

Call /s3/multipart/complete with all ETags

Call /s3/entries to create the file entry

If interrupted, use /s3/multipart/get-uploaded-parts to resume the upload where it left off.

Duplicate Validation

Before uploading, check if the file already exists:

const { duplicates } = await fetch('/uploads/validate', {
  method: 'POST',
  body: JSON.stringify({
    files: [{ name: 'photo.jpg', size: 1024, relativePath: '/photos' }]
  })
}).then(r => r.json());

if (duplicates.length > 0) {
  // Ask the user or auto-rename
  const { name } = await fetch('/entry/getAvailableName', {
    method: 'POST',
    body: JSON.stringify({ name: 'photo.jpg', parentId: null })
  }).then(r => r.json());
}

​Choosing the Right Method

Direct Upload

Presigned URL

Multipart Upload

​Simple Upload (< 5 MB)

​Presigned URL Upload (< 5 MB)

​Multipart Upload (≥ 5 MB)

​Duplicate Validation

Choosing the Right Method

Simple Upload (< 5 MB)

Presigned URL Upload (< 5 MB)

Multipart Upload (≥ 5 MB)

Duplicate Validation