user-preferences

Claim Release Announcement

Atomically claim a release spotlight and mark its visible digest as covered.

The user's canonical preference row is locked before inspecting the spotlight receipt. Exactly one concurrent request can therefore win on databases that support SELECT ... FOR UPDATE (including production PostgreSQL). SQLite uses BEGIN IMMEDIATE before the read to provide the same exact-once behavior; exhausted lock contention fails closed with a retryable 503. Each release is persisted under its own top-level key so a later generic preference merge cannot replace an entire receipt map.

post/api/preferences/release-announcements/claim

Request

  • Base URL: https://api.usepomo.ai (the document declares no server; this is the origin it was published from)
  • URL: https://api.usepomo.ai/api/preferences/release-announcements/claim
  • Auth: HTTP bearer

Request body

spotlight_release_idstring required

Stable ID of the release shown as the digest spotlight

release_idsstring[] required

Stable IDs covered by the announcement digest

Response

Successful Response

claimedboolean required
spotlight_release_idstring required
covered_release_idsstring[] required
claimed_atstring date-time required

Changes

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