Resolve a storage file path

Resolve a storage file path

Resolves <folder path>/<name>, a bare <name>, trickest://file/<path> or a file UUID to a single storage file, using the same rules workflow runs use. A bare name prefers the root file, then a single copy in a folder; several copies return 409 with every candidate path.

GET/api/files/resolve
Query parameters
pathstringrequired

Request

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

Responses

200Resolved file ({ id, name, path, folderPath, size, pretty_size, modified_date })
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.