ARarbital
Notifications

PATCH /v1/notifications/{id}/read

Idempotently acknowledges currently authorized, unsuppressed activity on one owned notification through the requested activity revision. Hidden activity is not individually acknowledged. Legacy bodyless requests acknowledge the server-observed boundary and return 204. A prior mark-all cutoff remains effective independently.

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/{id}/read
  • Auth
    HTTP bearer

Path parameters

idstring uuid required

Query parameters

contract'2'

Explicit v2 negotiation. Omission preserves the strict legacy contract.

Request body

through_activity_revisionstring required

Response

Authorized notification response

unread_countstring required
inbox_revisionstring required
read_watermarkstring uuid required
read_watermark_expires_at_unix_msinteger required
read_state'read' | 'unread' required

Changes

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