Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.drime.cloud/llms.txt

Use this file to discover all available pages before exploring further.

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