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:

  1. Go to Dashboard
  2. Navigate to Drive
  3. Click Settings
  4. 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

HeaderValueRequired
TokenYour storage access tokenYes (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

StatusMessageDescription
401Token requiredMissing authentication token
403Access deniedToken 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();
Built with 💖 by Miza • © 2026 - Powered by Nuxt