File Listing

List files and folders in your storage.

Rich Listing

GET /files/list - detailed format with download URLs.

Query parameters:

• path - folder path (default root)
• recursive - true / false
• limit - max 1000 (default 100)
• offset - pagination offset
• sort - name, size, modified, type
• order - asc or desc
• type - all, files, or folders

curl -G https://cloud.storra.host/api/v1/client/files/list \
  -H "X-API-Key: sk_your_api_key_here" \
  --data-urlencode "path=documents" \
  --data-urlencode "recursive=false" \
  --data-urlencode "sort=name" \
  --data-urlencode "order=asc"

Response (200): JSON array (not wrapped in an object).

[
  {
    "id": "file_550e8400",
    "name": "report.pdf",
    "path": "documents/report.pdf",
    "type": "file",
    "size": 1048576,
    "mime_type": "application/pdf",
    "created_at": "2025-06-01T10:30:00.000Z",
    "updated_at": "2025-06-01T11:00:00.000Z",
    "is_private": false,
    "download_url": "https://cloud.storra.host/api/v1/client/files/download/file_550e8400"
  }
]

Simple Listing

GET /list?folder_path={path} - compact format used by older integrations.

curl -G https://cloud.storra.host/api/v1/client/list \
  -H "X-API-Key: sk_your_api_key_here" \
  --data-urlencode "folder_path=documents"

Response (200):

[
  {
    "id": "file_550e8400",
    "path": "documents/report.pdf",
    "item_type": "FILE",
    "size_bytes": 1048576,
    "visibility": "PUBLIC",
    "created_at": "2025-06-01T10:30:00.000Z"
  }
]

visibility is PRIVATE, PUBLIC, or SHARED (SHARED when the item has active share permissions).

Rate Limits

Both /files/list and /list share one bucket: 100 requests per hour, including recursive queries.