Skip to content

Autonomous development for real products. Governed agents build from specs you approve, follow the rules you set, and nothing merges until another agent proves it. Your decisions, judgement and taste are the bar that work must clear. Declare your vision and let agents build it.

docs(api): document forgetting unreadable boards [N26]

Corey Olsoncfee0e9546a5
diff --git a/docs/api.md b/docs/api.md
index 75e85090..25e9a8ab 100644
--- a/docs/api.md
+++ b/docs/api.md
@@ -378,6 +378,7 @@ The server checks any Origin against its own address and grants no CORS permissi
| --- | --- |
| `GET /api/v1/settings?board=id` | Local-only read-only inventory: machine settings plus all authorized boards, or the selected board. Each row has `key`, `scope`, `value`, `default`, `source`, and `origin`; repo/board rows also identify `board` and `root`. Credential rows carry `secret: true` and only `set` or `not set`. Runtime events, queues and cached relay payloads are excluded. |
| `GET /api/v1/boards` | Registered boards with their project details and ids |
+| `POST /api/v1/projects/forget-unreadable` | Local view only, with the view session key in `x-pullboard-key`. Body exactly `{"confirm": true}`. Forgets the registered boards this machine can no longer find (`BOARD_UNAVAILABLE`) and returns `{version, forgotten}`; a board refused for a newer schema is kept. Refuses `BAD_REQUEST` for any other body, `VIEW_SIGN_IN_AUTH` without the key. |
| `GET /api/v1/boards/:board/state?seen=N` | The board state, listing item summaries, including open coordinator requests and the unseen shout count since N |
| `GET /api/v1/boards/:board/state?detail=full` | The same state with every item in full, which static view exports read |
| `GET /api/v1/boards/:board/state?since=N` | What changed in the summary state since the snapshot this server sent at event N, and the new latest sequence |