notify

Mark one notification

Changed on Oct 28, 2026

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

post/products/notify/inbox/{notificationId}/state

Request

Base URL
https://api.sparkvault.com/v1
Auth
- API key in header X-API-Key
- or HTTP bearer
TypeScript
https://skmtc.dev/sparkvault/apis/sparkvault-api/docs/products/notify/inbox/:notificationId/state/post.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

notificationIdstring required

The notification to mark.

Request body

recipient_idstring required

The inbox owner. Read in the form a send keys its recipient by (trimmed, with an email address lowercased the way Identity stores it), so the id or address as the send named it reads the same inbox. A value that is blank once trimmed, longer than 256 UTF-8 bytes, or holding a control character or noncharacter names no inbox and is rejected 400.

created_atinteger required

Unix seconds, from the inbox row.

state'seen' | 'read' | 'archived' required

Response

The notification was marked.

Changes

Oct 28, 2026a9a10e328ba5 Revision changes
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property became required for the status
- info
  the response property became required for the status
- info
  the response property became required for the status
- info
  the response property became required for the status
- info
  the response property became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
Oct 28, 202656d7c265a77a Revision changes
- breaking
  the response property / became nullable for the status
- breaking
  the response property / became nullable for the status
- breaking
  the response property / became nullable for the status
- breaking
  the response property / became nullable for the status
- breaking
  the response property / became nullable for the status

Operation history