Skip to main content

​
Endpoint

GET /storage
Auth: API Key required

​
Response

Returns the storage tree as a nested array. Each node is either a folder (with children) or a file (no children). 
[
  {
    "id": "photos",
    "name": "photos",
    "children": [
      {
        "id": "photos/portrait.jpg",
        "name": "portrait.jpg",
        "children": []
      },
      {
        "id": "photos/banner.png",
        "name": "banner.png",
        "children": []
      }
    ]
  },
  {
    "id": "video.mp4",
    "name": "video.mp4",
    "children": []
  }
]
​
id
string
Unique identifier — full path relative to storage root. Use this as the {path} parameter in other storage endpoints.
​
name
string
Display name of the file or folder.
​
children
array
Nested files and folders. Empty array [] for files or empty folders.

​
Example

curl http://localhost:3000/storage \
  -H "Authorization: Bearer <api_key>"

File Metadata

Get size and timestamps for a specific file.

Delete File

Remove a file and its cached variants.