Retrieve file metadata
Returns public file metadata for a pre-Thread uploaded file or a file attached to a public Thread visible to the API token caller.
GET
/files/{fileId}Returns public file metadata for a pre-Thread uploaded file or a file attached to a public Thread visible to the API token caller.
Authorization
publicApiBearer AuthorizationBearer <token>
Use Authorization: Bearer mst_... . API tokens identify an account and do not carry scopes.
In: header
Path Parameters
fileId*string
File ID returned by add or list Thread files. v1 IDs are bare ULIDs.
Match
^[0-7][0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{25}$Format
ulidResponse Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/files/01J0000000000000000000000J"{ "file": { "createdAt": "2026-05-19T00:02:00.000Z", "id": "01J0000000000000000000000J", "mimeType": "text/plain", "name": "brief.txt", "size": 19 }}{ "error": { "code": "agent_not_published", "message": "string" }}{ "error": { "code": "agent_not_published", "message": "string" }}{ "error": { "code": "agent_not_published", "message": "string" }}{ "error": { "code": "agent_not_published", "message": "string" }}{ "error": { "code": "agent_not_published", "message": "string" }}{ "error": { "code": "agent_not_published", "message": "string" }}{ "error": { "code": "agent_not_published", "message": "string" }}