Get a file by ID

Get a file by ID

Fetches a single file record from the user's storage vault by its ID. Pass name (the file's name or storage path) to resolve through one exact-name listing call instead of the newest-first id scan, which gives up after ~25,000 files.

GET/api/files/{id}
Path parameters
idstringrequired
Query parameters
namestring

Request

curl
curl -X GET https://trickest.io/api/files/{id} \
  -H "Authorization: Token $TRICKEST_TOKEN"

Responses

200File details
idstringrequired
namestringrequired
pathstringrequired
sizenumberrequired
content_typestring
created_datestringrequired
modified_datestringrequired
signed_urlstring
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.