docs
Notifications

Archive notifications

POST
/v1/notifications/archive

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.

Authorization

bearerToken
headerAuthorizationBearer <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".

Request Body

  1. body
ids*array<>
Items1 <= items <= 200

Response Body

Bad request: the body could not be parsed as JSON. Answered before the route runs.

application/json
  1. response
error*string
Example Request
curl -X POST 'http://localhost:3000/api/v1/notifications/archive' \  -H 'Content-Type: application/json' \  -d '{  "ids": [    "string"  ]}'
Example Response
{  "error": "string"}