Introducing Agents.·Read
Getting StartedKey ConceptsHow-to GuidesCLITrickest SDKSandbox SDKAPI ReferenceChangelog
List storage folders

List storage folders

Lists the authenticated user's virtual storage folders, optionally filtered by parent path, with per-folder file and child counts.

GET/api/storage/folders
Query parameters
vaultIdstring
parentPathstring

Request

curl
curl -X GET https://trickest.io/api/storage/folders \
  -H "Authorization: Bearer $TRICKEST_TOKEN"

Responses

200List of folders
foldersobject[]required

countinteger
400Bad Request – validation error or malformed input
codestringrequired
messagestringrequired
detailsobject

Field-level detail when the error is a validation failure.

401Unauthorized – missing or expired token
codestringrequired
messagestringrequired
detailsobject

Field-level detail when the error is a validation failure.

403Forbidden – insufficient permissions
codestringrequired
messagestringrequired
detailsobject

Field-level detail when the error is a validation failure.

429Too Many Requests – rate limited
codestringrequired
messagestringrequired
detailsobject

Field-level detail when the error is a validation failure.

500Internal Server Error
codestringrequired
messagestringrequired
detailsobject

Field-level detail when the error is a validation failure.

PreviousSpace-roleList roles for a spaceStorageNextCreate a storage folder