File Download

Stream files by ID returned from upload or listing.

Download File

GET /files/download/{file_id}

curl -X GET https://cloud.storra.host/api/v1/client/files/download/file_550e8400 \
  -H "X-API-Key: sk_your_api_key_here" \
  -o downloaded.pdf

Returns the file binary with headers:

• Content-Type - MIME type
• Content-Length
• Content-Disposition: attachment; filename="..."
• ETag, Last-Modified

HEAD Metadata

HEAD /files/download/{file_id} - same auth and rate limit, returns headers without a body.

File ID Format

Accepts file_{uuid-prefix} labels from API responses, or a raw UUID prefix that uniquely matches one of your files.

Rate Limits

200 download requests per hour per API key (GET and HEAD share the same bucket).