Get File Status
Get one file’s processing status, and a short-lived download URL for it.
Poll this after uploading the bytes: a file is only searchable once embedding has finished. A failure reports why here rather than by disappearing from the list.
Your own files are always reachable. Another member’s file in the same org is
reachable when your role holds files:read across the org; with an API key, the
key’s owner’s role decides. A file you cannot reach answers 404, not 403 — the
response deliberately does not confirm that someone else’s file_id exists.
Authorizations
Enter your MeshAPI key (rsk_...) or, for the admin-keys endpoints, a dashboard session token — sent as Authorization: Bearer <token>.
Headers
Dated version of the API contract to pin this request to. Omit it and the request is served under 2026-08 — the oldest supported version, so an existing integration is never moved by a release. A malformed or unsupported value is rejected with 400 invalid_api_version rather than falling back silently. The version actually served is echoed as X-Mesh-Version on every response, including errors.
2026-08, 2026-09 Path Parameters
Response
Successful Response
User id of the uploader.
Uploader's email, on the org-wide list for a caller who can read members.