Base URL
All API endpoints are relative to:Authentication
All requests require a Bearer token in theAuthorization header:
Learn more about authentication
See the authentication guide for details on obtaining and using tokens
Response Format
All responses are returned in JSON format with a consistent structure:Success Response
Error Response
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 |
Pagination
List endpoints support pagination with these parameters:| Parameter | Type | Default | Description |
|---|---|---|---|
page | integer | 1 | Page number |
perPage | integer | 50 | Items per page |
Workspace Context
Many endpoints accept aworkspaceId parameter:
- Use
0for your personal/default workspace - Use a specific workspace ID for team workspaces
Rate Limiting
The API implements rate limiting to ensure fair usage. If you exceed the limit, you’ll receive a429 Too Many Requests response.
API Categories
Authentication
Login, register, and manage tokens
Files & Folders
Browse, create, and manage files
Uploads
Upload files to the cloud
Sharing
Share files with others
Vault
Encrypted storage
Workspaces
Team collaboration

