Archive notifications
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.
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 <= 200Bad 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/archive' \ -H 'Content-Type: application/json' \ -d '{ "ids": [ "string" ]}'{ "error": "string"}Change my notification preferences PATCH
Partial: an event or a channel left out keeps its value. Answers the preferences, like the GET. 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`.
Mark notifications read POST
`{ 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`.