# Files

## Endpoint Summary

| Method | Path | Purpose |
| --- | --- | --- |
| `GET` | `/v1/files` | List a workspace directory |
| `GET` | `/v1/files/read` | Read a workspace file |

## Directory Listing

`GET /v1/files?path=<relative-or-absolute>` returns directory entries for the active or requested workspace.

## File Read

`GET /v1/files/read?path=<path>` reads file content where policy permits.

File operations are subject to workspace, auth, and profile restrictions. Remote clients should not assume arbitrary filesystem access.
