List Files
List files in the org you are acting in, newest first.
With an API key you see the files that key’s owner uploaded. Signed in to the
dashboard, you also see the rest of the org’s files when your role holds
files:read across the org (owner, admin and viewer do); otherwise you see your
own. Each entry carries the same fields as GET /v1/files/{file_id}, including
the embedding status, so you can poll this instead of one file at a time.
Paginate with limit (1–200, default 50) and offset; total is the unpaginated
count. q narrows the list to names containing that text.
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 Query Parameters
1 <= x <= 200x >= 0Only files whose name contains this text (case-insensitive).
1 - 200