Cloud API Documentation

Welcome to the Storra Cloud API documentation. Every endpoint described here is implemented in this application under /api/v1/client.

Overview

Storra Cloud provides secure file storage with a REST API for programmatic access. Authenticate with an API key in the X-API-Key header.

• File management - upload, download, list, move, copy, delete
• Folders - create folders and read folder metadata
• Sharing - grant VIEW, EDIT, or OWNER permissions to other registered users
• Trash - soft-delete with restore and empty

Requirements

API access requires a Cloud Pro subscription (plan_pro). Free and Plus accounts receive 403 when using the client API. Create API keys from Authentication after upgrading.

Base URL

All client API routes are rooted at:

https://cloud.storra.host/api/v1/client

Endpoints

• User Management - GET /users/me, PATCH /users/me/preferences
• File Upload - POST /files/upload
• File Download - GET|HEAD /files/download/{file_id}
• File Listing - GET /files/list, GET /list
• File Operations - move, copy, duplicate, privacy, delete, trash
• Folder Management - POST /create-folder, GET /info/{path}
• File Sharing - permissions grant, list, update, revoke

See also Error Handling and Rate Limiting.

First Request

curl -X GET https://cloud.storra.host/api/v1/client/users/me \
  -H "X-API-Key: sk_your_api_key_here"