Fetch atomic selected-item changes

Adds, edits and removals since your cursor, so a local copy stays correct without re-downloading anything. Apply a page, then save the returned cursor — never the other way round. The cursor is a ledger watermark, not a session: it does not expire on a timer, so a client may go offline for days and resume exactly where it stopped. On 409 snapshot_required, re-bootstrap from /api/v1/selected/snapshot; that response is the only signal that resuming is no longer safe.

get/api/v1/selected/changes

Request

  • Base URL: https://bithot.news
  • URL: https://bithot.news/api/v1/selected/changes
  • Auth: none declared

Query parameters

cursorstring required
limitinteger

Headers

User-Agentstring

The client's normal User-Agent (optional; any value works).

If-None-Matchstring

Previously received ETag for this exact URL. A match returns 304 without a response body.

Response

OK

OR

Example response

{
  "changes": [
    {
      "item": {
        "category": "projects"
      }
    }
  ]
}

Changes

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