Storage

List files stored by the calling account

Requires scope files:read. Returns the files stored under the calling account, each augmented with its current on chain deal status (best effort) and a public content addressed retrieval URL. Supports folder filtering, name search, sorting, and paging.

GET/api/v1/account/filesTry it

iNote

Requires a key with the files:read scope, sent as Authorization: Bearer <api-key>. Keys missing the scope are rejected with 403 — see Authentication.

Query parameters

Name	In	Type	Description
folder	query	string	Only files whose folder equals this value. Pass an empty string for files with no folder. Omit for all files.
q	query	string	Case-insensitive substring match on the file name.
sort	query	string	date is newest first, name is A-Z, size is largest first.
offset	query	integer	Number of files to skip after filtering and sorting.
limit	query	integer	Maximum number of files to return.

Errors

Code	Meaning
401	Invalid or missing API key.
403	The API key lacks the required scope for this operation.

cURL

curl https://gateway.kepto.xyz/api/v1/account/files \
  -H "Authorization: Bearer <api-key>"

200 · application/json

{
  "total": 0,
  "folders": [
    "string"
  ],
  "files": [
    {
      "root": "string",
      "name": "string",
      "sizeBytes": 0,
      "createdAt": 0,
      "privacy": "public",
      "dealId": 0,
      "folder": "string",
      "status": "string",
      "contentUrl": "string"
    }
  ]
}