ARarbital
Notifications

POST /v1/notifications/read-all

Atomically marks every owned notification admission at or below the live server-issued checkpoint read, including activity currently hidden or suppressed. Older activity remains read if it later becomes visible; activity admitted above the checkpoint stays unread, including on an older group. updated_activity_count reports only currently authorized, unsuppressed newly acknowledged admissions, so a hidden-only cutoff advance can return zero while advancing inbox_revision once. Repeating the same or an older cutoff does not change read state. List, count and target authorization remain current; unavailable required source visibility or a deadline failure rolls back the entire operation. Responses are private, no-store. Reviewed capability and migration gates still apply.

Request

  • Base URL
    https://api.arbital.xyz (the document declares no server; this is the origin it was published from)
  • URL
    https://api.arbital.xyz/v1/notifications/read-all
  • Auth
    HTTP bearer

Request body

throughstring uuid required

Response

Authorized notification response

unread_countstring required
inbox_revisionstring required
read_watermarkstring uuid required
read_watermark_expires_at_unix_msinteger required
acknowledged_through_revisionstring required

The committed recipient boundary resolved from the supplied owned checkpoint. All owned activity at or below it is acknowledged, including hidden activity; a previously higher cutoff is never lowered.

updated_activity_countstring required

Count of currently authorized, unsuppressed admissions newly acknowledged by this call. Excludes hidden admissions and is not a count of physical database row updates. May be zero while a higher cutoff advances inbox_revision.

Changes

No recorded changes to this operation across all 1 revision of this API.