Folder Management

Create folders and read folder metadata.

Create Folder

POST /create-folder - returns 201.

{ "folder_path": "projects/2025" }

Response:

{
  "id": "folder_abc123",
  "path": "projects/2025",
  "item_type": "FOLDER",
  "size_bytes": 0,
  "visibility": "PRIVATE",
  "created_at": "2025-06-01T10:30:00.000Z"
}

List Folder Contents

Use GET /files/list with the path parameter, or GET /list with folder_path.

Folder Info

GET /info/{folder_path} - e.g. GET https://cloud.storra.host/api/v1/client/info/projects/2025

Returns folder metadata including recursive size_bytes and owner. Root path without a folder returns 404.

Rate Limits

Create folder and folder info share the folder bucket: 100 requests per hour.