Client OS API
Documents and LLM context
Documents, local folders and the Context files that make up a Client’s LLM context.
LLM context files are the database copy of the Context files `client clientos sync-files` reads from disk.
Operations
| Request | What it does |
|---|---|
| GET /api/clientos/documents | List records (org:viewer or above) |
| POST /api/clientos/documents | Create a record (org:contributor or above) |
| GET /api/clientos/documents/{id} | Get one record (org:viewer or above) |
| PATCH /api/clientos/documents/{id} | Update a record (org:contributor or above) |
| DELETE /api/clientos/documents/{id} | Delete a record (org:admin) |
| GET /api/clientos/local-folders | List records (org:viewer or above) |
| POST /api/clientos/local-folders | Create a record (org:contributor or above) |
| GET /api/clientos/local-folders/{id} | Get one record (org:viewer or above) |
| PATCH /api/clientos/local-folders/{id} | Update a record (org:contributor or above) |
| DELETE /api/clientos/local-folders/{id} | Delete a record (org:admin) |
| GET /api/clientos/llm-context-files | List records (org:viewer or above) |
| POST /api/clientos/llm-context-files | Create a record (org:contributor or above) |
| GET /api/clientos/llm-context-files/{id} | Get one record (org:viewer or above) |
| PATCH /api/clientos/llm-context-files/{id} | Update a record (org:contributor or above) |
| DELETE /api/clientos/llm-context-files/{id} | Delete a record (org:admin) |
Methods and paths come from packages/api-client/openapi.json, which CI regenerates from the route definitions; this site builds its lists from that file. Every /api operation needs a Supabase Auth JWT or a PAT and is rate limited. /health and /health/deep are plain routes outside the spec.