Get a signed URL for file download/preview.

Get a signed URL for file download/preview.

Returns a signed download/preview URL and size for a file in the user's storage vault. Pass name (the file's name or storage path) to resolve the ownership check through one exact-name listing call instead of the newest-first id scan, which gives up after ~25,000 files.

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

Request

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

Responses

200Signed URL and size ({ url, size }); bespoke body, no entity schema
successboolean
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.