Skip to main content

​
Get Your API Token

Before making API requests, you need an access token. You can get one in two ways:
  1. Log in to Drime Cloud
  2. Go to Account Settings → Developers
  3. Click Create a token
  4. Name your token and click Create
  5. Copy and save your token securely

​
Make Your First Request

Use your token in the Authorization header: 
curl https://app.drime.cloud/api/v1/cli/loggedUser \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

​
Upload Your First File

1

Get a presigned URL

For files under 5MB, use the simple upload flow:
curl -X POST https://app.drime.cloud/api/v1/s3/simple/presign \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "filename": "document.pdf",
    "mime": "application/pdf",
    "size": 1048576,
    "extension": "pdf",
    "workspaceId": 0
  }'
2

Upload to S3

Upload the file to the presigned URL:
curl -X PUT "PRESIGNED_URL_FROM_STEP_1" \
  -H "Content-Type: application/pdf" \
  --data-binary @document.pdf
3

Create the file entry

Register the file in Drime Cloud:
curl -X POST https://app.drime.cloud/api/v1/s3/entries \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "filename": "UUID_FROM_KEY",
    "size": 1048576,
    "clientName": "document.pdf",
    "clientMime": "application/pdf",
    "clientExtension": "pdf",
    "workspaceId": 0
  }'

​
List Your Files

curl https://app.drime.cloud/api/v1/drive/file-entries?workspaceId=0 \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
Response: 
{
  "data": [
    {
      "id": 123456,
      "name": "document.pdf",
      "type": "pdf",
      "file_size": 1048576,
      "hash": "MTIzNDU2fA",
      "created_at": "2024-01-15T10:30:00.000000Z"
    }
  ],
  "current_page": 1,
  "total": 1
}

​
Next Steps

Authentication

Learn more about authentication methods

API Reference

Explore all available endpoints

Multipart Uploads

Upload large files with multipart

Sharing

Share files with others