File Upload

Upload files via multipart form data.

Endpoint

POST /files/upload

Request

multipart/form-data fields:

• file (required) - the file to upload
• path (optional) - destination folder, default . (root). Parent folders are created automatically.
• is_private (optional) - "true" or "false" string, default public

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 "path=documents/reports" \
  -F "is_private=true"

Upload one file per request. For multiple files, send separate requests.

Response

200 OK:

{
  "path": "documents/reports/report.pdf",
  "item_type": "file",
  "id": "file_550e8400",
  "size_bytes": 1048576,
  "created_at": "2025-06-01T10:30:00.000Z",
  "visibility": "private",
  "permissions": [],
  "owner": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "email": "you@example.com",
    "username": "you",
    "discord_id": null,
    "discord_avatar": null,
    "profile_picture": null
  }
}

id uses the file_ prefix with a UUID prefix for downloads.

Plan Limits

Cloud Pro limits (from your plan):

• Max file size: 1 GB per file
• Storage quota: 25 GB total

Exceeded size returns 413. Exceeded quota returns 413 with a quota message.

Rate Limits

50 uploads per hour per API key.