Quick Start - Drime Cloud API

Get Your API Token

Before making API requests, you need an access token. You can get one in two ways:

From Dashboard
Via API

Log in to Drime Cloud
Go to Account Settings → Developers
Click Create a token
Name your token and click Create
Copy and save your token securely

Make a POST request to the login endpoint:

curl -X POST https://app.drime.cloud/api/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{
    "email": "your@email.com",
    "password": "your_password",
    "device_name": "My App"
  }'

The response will include your access_token:

{
  "status": "success",
  "user": {
    "id": 12345,
    "email": "your@email.com",
    "access_token": "123|abcdef1234567890..."
  }
}

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"

const response = await fetch('https://app.drime.cloud/api/v1/cli/loggedUser', {
  headers: {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN'
  }
});

const data = await response.json();
console.log(data.user);

import requests

headers = {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN'
}

response = requests.get(
    'https://app.drime.cloud/api/v1/cli/loggedUser',
    headers=headers
)

print(response.json())

Upload Your First File

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
  }'

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

Create the file entry

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

​Get Your API Token

​Make Your First Request

​Upload Your First File

​List Your Files

​Next Steps