List folders, files in one folder, and space used

The account's whole folder tree (flat, each entry carrying its full path and file count), the files sitting in the requested folder, and bytes used against the plan limit.

Folders are metadata: they never affect retention, pricing or what a file costs to store. Deleted and failed uploads are excluded, so the listing and the quota always agree.

get/v1/storage

Request

  • Base URL: https://api.payaion.com
  • URL: https://api.payaion.com/v1/storage
  • Auth: one of:
    • API key in header X-Aion-Key
    • HTTP bearer

Query parameters

folderIdstring

Folder to list files from. Omit, or pass root, for the storage root.

Response

Folder tree, the requested folder's files, and usage

Example response

{
  "folder": {
    "path": "Clients/Acme"
  },
  "folders": [
    {
      "path": "Clients/Acme"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.