APIDevelopers

Getting Started with the Storra Cloud API

By Storra TeamJune 18, 20256 min read

The Storra Cloud API lets you upload, download, list, move, and share files from any backend or script. If you are building an app, automating backups, or piping uploads from CI, this is the integration path - permanent storage with clean REST endpoints under /api/v1/client.

Before you start

A Cloud Pro subscription - API access requires the Pro plan. Check pricing for details.
An API key from Dashboard → Settings → API Keys.
The full reference in our API documentation.

Authenticate every request

Pass your API key in the X-API-Key header. Keys are scoped to your account - treat them like passwords and rotate them from the dashboard if compromised. See the authentication docs for rate limits and error responses.

Upload your first file

Send a multipart POST to /api/v1/client/files/upload with your file and an optional folder path. The response includes a file ID you can use for downloads, sharing, and embeds. Full examples are in the file upload guide and SDK examples.

curl -X POST https://cloud.storra.host/api/v1/client/files/upload \
  -H "X-API-Key: sk_your_api_key_here" \
  -F "file=@./report.pdf" \
  -F "folder_path=reports/2025"

List and download

Use GET /files/list to browse folders, then GET /files/download/{file_id} to stream the binary. HEAD requests return metadata without a body - useful for sync tools that check ETags before re-downloading.

Share with permissions

Grant VIEW, EDIT, or OWNER access to other registered users via the permissions API. Public permanent links are also available from the dashboard for files marked public - ideal for embeds and CDN-style delivery.