---
title: "Mark a recipient inbox in bulk"
method: POST
path: "/products/notify/inbox/state"
tags: ["notify"]
---

# Mark a recipient inbox in bulk

`POST /products/notify/inbox/state`

Mark a page of notifications seen or read. Page size is fixed server-side; keep calling with the returned cursor until it is null. Archiving in bulk is deliberately not offered.

## Request body

- object
  - `recipient_id` string, required
  - `state` 'seen' | 'read', required
  - `cursor` string — Continuation token from the previous call.

## Response `200`

The page was marked.

- object
  - `data` object, required
    - `updated` integer, required — Rows marked on this page.
    - `cursor` string, nullable, required — Opaque continuation token. Null when the listing is exhausted.
  - `meta` ResponseMeta — Envelope metadata present on every successful response.
    - `api_version` string
    - `request_id` string
    - `response_ms` integer
    - `timestamp` integer — Unix seconds.
    - `pools` object — Storage and bandwidth capacity snapshot for the account.
    - `billing` object
      - `past_due` boolean
    - `quota` object — This minute of the account request budget. Present on authenticated success responses that passed the throttle; absent otherwise.
      - `limit` integer
      - `used` integer
      - `remaining` integer
      - `resets_at` integer — Unix seconds.

## Other responses

- `400` — VALIDATION_ERROR — the message names the offending field.
- `401` — AUTHENTICATION_ERROR — missing or invalid credentials.
- `403` — FORBIDDEN — the caller may not act on this account.
- `429` — RATE_LIMIT_EXCEEDED — the account exceeded 300 requests this minute. `Retry-After` carries the seconds to wait, and `details` carries limit/resets_at, plus `used` whenever the request was counted. A request refused because the limiter itself was unavailable reports no `used`.

---

[API](https://skmtc.dev/sparkvault/apis/sparkvault-api.md) · [All operations](https://skmtc.dev/sparkvault/apis/sparkvault-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sparkvault/sparkvault-api/revisions/aaf3fd4981d9/schema)