---
title: "Mark one notification"
method: POST
path: "/products/notify/inbox/{notificationId}/state"
tags: ["notify"]
---

# Mark one notification

`POST /products/notify/inbox/{notificationId}/state`

Set a notification to seen, read, or archived. `created_at` is the row sort key.

## Path parameters

- `notificationId` string, required

## Request body

- object
  - `recipient_id` string, required
  - `created_at` integer, required — Unix seconds, from the inbox row.
  - `state` 'seen' | 'read' | 'archived', required

## Response `200`

The notification was marked.

- object
  - `data` object, required
    - `notification_id` string, required
    - `state` 'seen' | 'read' | 'archived', required
    - `updated_at` integer, required
  - `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.
- `404` — NOT_FOUND — no such notification for this recipient.
- `429` — RATE_LIMIT_EXCEEDED — the account exceeded 5000 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/a7807da394b8/schema)