Skip to main content
POST
/
uploads
curl -X POST https://app.drime.cloud/api/v1/uploads \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -F "file=@/path/to/document.pdf" \
  -F "parentId=" \
  -F "workspaceId=0"

{
  "status": "success",
  "fileEntry": {
    "id": 123456,
    "name": "document.pdf",
    "type": "pdf",
    "mime": "application/pdf",
    "file_size": 1048576,
    "hash": "MTIzNDU2fA",
    "parent_id": null,
    "workspace_id": 0,
    "created_at": "2024-01-20T10:00:00.000000Z"
  }
}

​
Overview

Uploads a file directly to Drime Cloud using multipart form data. This is the simplest upload method but recommended only for smaller files.
For files larger than 5MB, consider using the presigned URL or multipart upload flow for better reliability.

​
Request Body (multipart/form-data)

​
file
file
required
The file to upload
​
parentId
integer
ID of the destination folder. Use null for root.
​
workspaceId
integer
Workspace ID. Use 0 for personal workspace.
​
relativePath
string
Optional folder path. Folders will be auto-created if they don’t exist. Format: /some/folders/here/file-name.jpg

​
Response

​
fileEntry
object
The created file entry object
​
status
string
Request status (success)
curl -X POST https://app.drime.cloud/api/v1/uploads \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -F "file=@/path/to/document.pdf" \
  -F "parentId=" \
  -F "workspaceId=0"

{
  "status": "success",
  "fileEntry": {
    "id": 123456,
    "name": "document.pdf",
    "type": "pdf",
    "mime": "application/pdf",
    "file_size": 1048576,
    "hash": "MTIzNDU2fA",
    "parent_id": null,
    "workspace_id": 0,
    "created_at": "2024-01-20T10:00:00.000000Z"
  }
}