Change my notification preferences
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.
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
channels?Bad request: the body could not be parsed as JSON. Answered before the route runs.
application/json- response
error*stringcurl -X PATCH 'http://localhost:3000/api/v1/me/notification-preferences' \ -H 'Content-Type: application/json' \ -d '{}'{ "error": "string"}Count my unread notifications GET
`{ unread }`: what the header bell shows. Unread means not read and not archived.
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`.