Getting Started

Get up and running with the Storra Cloud API in a few minutes.

Prerequisites

1. Create an account at /dashboard/signup
2. Upgrade to Cloud Pro - API keys and client API routes require plan_pro
3. Generate an API key in Dashboard → Settings → API Keys

Create an API Key

From the dashboard, click Create API Key, give it a label, and copy the full key (shown once). Keys use the sk_ prefix.

To manage keys programmatically while logged into the dashboard, use the dashboard API with your session cookie - not Bearer tokens.

Make Your First API Call

Verify your key by fetching your profile:

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

A successful response includes your user ID, email, upload preference, and subscription storage usage.

Upload a File

curl -X POST https://cloud.storra.host/api/v1/client/files/upload \
  -H "X-API-Key: sk_your_api_key_here" \
  -F "file=@document.pdf" \
  -F "path=documents" \
  -F "is_private=false"

Continue with File Listing and File Download.