# `GET /vfs`

Protected. Requires a valid session cookie (`credentials: 'include'`).

List virtual filesystem files

Lists all virtual filesystem files for the authenticated user's selected company.
Scans directories recursively (ignoring hidden dotfiles) and returns file
metadata including path, byte size, detected MIME type, timestamps, and classification flags.


## Response `200`

List of virtual filesystem files

```json
{
  "files": [
    {
      "name": "…",
      "size": 1,
      "mime": "…",
      "updated_at": "2026-08-10T00:00:00.000Z",
      "created_at": "2026-08-10T00:00:00.000Z",
      "isText": true,
      "isImage": true,
      "isPdf": true
    }
  ]
}
```

## Errors

| Status | Description |
|--------|-------------|
| 400 | No company selected — `{"error":"…"}` |
| 401 | Unauthorized — `{"error":"…"}` |
| 403 | Not authorized — `{"error":"…"}` |

---

_Generated from `@openapi` JSDoc. Do not edit by hand — run `npm run docs:api`._