Quick Start

Get Your API Token

Before making API requests, you need an access token. For your own account, create a personal access token:

Sign in to Drime
Open Settings and go to Developers, or use the direct link
Click Create token, name it, choose its permissions and click Create
Copy the token and store it somewhere safe: it is shown once

Building an application that other Drime users will connect? Use OAuth instead. Your users approve it on Drime, and you never handle their password.

Make Your First Request

Use your token in the Authorization header:

curl https://app.drime.cloud/api/v1/users/me \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

const response = await fetch('https://app.drime.cloud/api/v1/users/me', {
  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/users/me',
    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 Started

OAuth Applications

Get Your API Token

Make Your First Request

Upload Your First File

List Your Files

Next Steps

Authentication

API Reference

Multipart Uploads

Sharing

​Get Your API Token

​Make Your First Request

​Upload Your First File

​List Your Files

​Next Steps

Authentication

API Reference

Multipart Uploads

Sharing

Get Your API Token

Make Your First Request

Upload Your First File

List Your Files

Next Steps