Storage
Authentication
How to authenticate with the Cludz Storage API using storage tokens.
Getting Your Storage Token
Storage Token is different from API Key. Storage Token is obtained from Dashboard > Drive > Settings > Storage Token, while API Key for Cludz API is obtained from Dashboard > API Key.
To get your Storage Token:
- Go to Dashboard
- Navigate to Drive
- Click Settings
- Copy your Storage Token
Authentication Methods
Cludz Storage uses token-based authentication. Include the token in the Token header for all requests.
curl -X GET "https://storage.cludz.net/storage/{uuid}/" \
-H "Token: YOUR_STORAGE_TOKEN"
Token Header
| Header | Value | Required |
|---|---|---|
Token | Your storage access token | Yes (for non-public resources) |
Alternatively, you can pass the token as a query parameter:
curl -X GET "https://storage.cludz.net/storage/{uuid}/?token=YOUR_STORAGE_TOKEN"
Token Types
Storage Owner Token
Full access to the storage including all read, write, and delete operations.
Shared Access Token
Limited access based on folder permissions. Can be restricted to:
- Read - View and download files
- Write - Upload and modify files
- Delete - Remove files and folders
Public Access
For resources marked as Public, authentication is optional for GET requests:
# Public file - no token needed
curl -X GET "https://storage.cludz.net/storage/{uuid}/public/image.jpg"
Write and delete operations always require authentication, even for public folders.
Error Responses
| Status | Message | Description |
|---|---|---|
401 | Token required | Missing authentication token |
403 | Access denied | Token lacks required permissions |
Example: Authenticated Request
const response = await fetch('https://storage.cludz.net/storage/{uuid}/documents/', {
headers: {
'Token': 'YOUR_STORAGE_TOKEN'
}
});
const files = await response.json();
import requests
response = requests.get(
'https://storage.cludz.net/storage/{uuid}/documents/',
headers={'Token': 'YOUR_STORAGE_TOKEN'}
)
files = response.json()
