# List files

`GET /v1/files`

List files visible to your key, optionally filtered by project. Requires `files:read`.

## Parameters

- `project_id` (query) — Restrict to one project.

## Authentication

Bearer `sk-rav-...` API key in the `Authorization` header.

Full request/response schemas: https://docs.rav.chat/api-reference/files/list-files