Skip to main content
GET
Preview. This endpoint is available to organisations in the Wordsmith MCP and files pilot. Other organisations receive 403 mcp_not_enabled. See the preview overview.
Returns a file’s metadata. To read its contents, use Get File Text or Get File Download. You can read any file you have access to in Wordsmith, not only files you added through the API. A file that does not exist and a file you cannot read both return 404, so the response never reveals whether an id exists.

​
Authentication

Send an API key, or an OAuth access token with the files:read scope, as a bearer token in the Authorization header. files:write does not include files:read. A token without the scope gets 403 with "error": "insufficient_scope".

​
Path parameters

​
string (uuid)
required
The file’s id, as the files endpoints and task input_files and output_files return it.

​
Response

​
string (uuid)
The file’s id.
​
string | null
The file’s name.
​
string | null
The file’s MIME type.
​
integer | null
Size in bytes.
​
string | null
When the file was created. ISO 8601 UTC.

​
Errors

See Errors for the error format.