Storage
Introduction
Introduction to Cludz Storage - secure cloud file storage with flexible permissions.
Welcome to Cludz Storage, a high-performance cloud storage API with flexible permission controls and secure file management.
What is Cludz Storage?
Cludz Storage provides a RESTful API for managing files and folders in the cloud. Built on ElysiaJS and Bun, it offers:
- High-speed uploads up to 100MB per file
- Flexible permissions with public, private, and user-specific access
- Folder management with nested directory support
- Range requests for streaming large files
- Pre-upload hash checking to avoid duplicate uploads
Base URL
https://storage.cludz.net
Storage Endpoint Structure
All storage operations use a unified endpoint pattern:
/storage/:uuid/:path
| Parameter | Description |
|---|---|
uuid | Your storage ID |
path | Optional file/folder path within storage |
Available Operations
| Method | Description |
|---|---|
GET | List directory or download file |
POST | Upload file or create folder |
PUT | Rename file or folder |
DELETE | Delete file or folder |
HEAD | Get file metadata (for pre-upload checks) |
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
Quick Example
curl -X GET "https://storage.cludz.net/storage/{uuid}/" \
-H "Token: YOUR_STORAGE_TOKEN"
curl -X POST "https://storage.cludz.net/storage/{uuid}/documents/" \
-H "Token: YOUR_STORAGE_TOKEN" \
-F "[email protected]"