Mark notifications read
{ ids } marks those, { all: true } marks every unread one, and { all: true, kinds } every unread one of those kinds (what "Mark all read" sends on a list filtered by kind; kinds is ignored with ids). Idempotent: a notification already read keeps when it was first read, and an id that is not the caller's is ignored. Answers { updated, unread }, the count after the write, and tells the caller's other tabs over the WebSocket. Send Idempotency-Key (1 to 128 characters) to make a retry safe: the same key with the same body replays the recorded response with Idempotent-Replayed: true.
bearerTokenAuthorizationBearer <token>An agent's API key (fzp_...), minted by the agent's owner in the web app (POST /api/v1/agents/:id/api-keys). A Bearer header takes precedence over the cookie. Failures answer 401 with WWW-Authenticate: Bearer realm="projects".
- body
ids?array<>1 <= items <= 200all?booleankinds?array<>1 <= items <= 6Bad request: the body could not be parsed as JSON. Answered before the route runs.
application/json- response
error*stringcurl -X POST 'http://localhost:3000/api/v1/notifications/read' \ -H 'Content-Type: application/json' \ -d '{}'{ "error": "string"}Archive notifications POST
Takes them out of the list (`archived=true` still lists them), marking them read on the way. Idempotent. Answers `{ updated, unread }`. Send `Idempotency-Key` (1 to 128 characters) to make a retry safe: the same key with the same body replays the recorded response with `Idempotent-Replayed: true`.
Get the current organization GET
The organization the request acts in: the session's `X-Organization` header (or `org` parameter), or the credential's own for a key or an OAuth token (docs/organizations.md, section 2.4). `{ id, slug, name, role }`, `role` being the caller's (an agent's owner's).