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

List files

Lists files from the authenticated user's storage vault, with pagination, search, ordering, and optional virtual-folder filtering.

GET/api/files
Query parameters
searchstring
pageinteger
page_sizeintegerrequireddefault: 100
orderingstringrequireddefault: -modified_date
folderstring
unfiledstring

Request

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

Responses

200Paginated list of files
resultsobject[]required

countinteger
nextstring
previousstring
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.

PreviousExportsGet an export download URLFilesNextUpload a file