Base URL
All API endpoints are relative to:
https://app.drime.cloud/api/v1
Authentication
All requests require a Bearer token in the Authorization header:
Authorization: Bearer YOUR_ACCESS_TOKEN
Learn more about authentication
See the authentication guide for details on obtaining and using tokens
All responses are returned in JSON format with a consistent structure:
Success Response
{
"status": "success",
"data": { ... }
}
Error Response
{
"status": "error",
"message": "Description of the error",
"errors": {
"field_name": "Specific error message"
}
}
HTTP Status Codes
| Code | Description |
|---|
200 | Success |
201 | Created |
400 | Bad Request |
401 | Unauthorized - Invalid or missing token |
403 | Forbidden - Insufficient permissions |
404 | Not Found |
422 | Validation Error |
500 | Server Error |
List endpoints support pagination with these parameters:
| Parameter | Type | Default | Description |
|---|
page | integer | 1 | Page number |
perPage | integer | 50 | Items per page |
Paginated responses include:
{
"data": [...],
"current_page": 1,
"last_page": 5,
"per_page": 50,
"total": 234,
"from": 1,
"to": 50
}
Workspace Context
Many endpoints accept a workspaceId parameter:
- Use
0 for your personal/default workspace
- Use a specific workspace ID for team workspaces
GET /drive/file-entries?workspaceId=0
Rate Limiting
The API implements rate limiting to ensure fair usage. If you exceed the limit, you’ll receive a 429 Too Many Requests response.
If you need higher rate limits for your application, contact our support team.
API Categories