ackDB

Advance one bounded segment bootstrap page

Internal Segment Sync expansion contract: evaluates at most one keyset page, returns those exact member ids, and inserts the same ids into an unfinished ackDB snapshot in one short transaction. A downstream ledger consumes this response directly, so initial sync no longer runs the segment filter once for the snapshot and again for the ledger. Replaying an already covered after page is idempotent; a cursor ahead of durable progress is rejected. Existing bootstrapped segments use the same endpoint as a live read for additional connections. Pass the first page's filterHash as expectedFilterHash on later pages; a mid-seed filter edit returns 409 FILTER_CHANGED before writing a mixed page.

post/api/v1/ackdb/observe/segments/{id}/bootstrap-page

Request

  • Base URL
    http://localhost:3009
  • Auth
    HTTP bearer

Path parameters

idstring required

Query parameters

afterstring

Keyset cursor from the previous page. Omit for page one or a replay of page one.

limitinteger

Page size (default 1000, max 5000).

expectedFilterHashstring

Opaque filter version returned by page one; later pages fail closed if it changed.

Response

The exact member page used to advance the snapshot.

segmentIdstring required
entityIdsstring[] required

Member ids (company entity_id or contact_id), ascending.

nextCursorstring nullable required

Pass as ?after= for the next page; null when the set is exhausted.

hasMoreboolean required
filterHashstring nullable

The membership's version hash (same value /changes carries). A multi-page seed that sees it change between pages straddles two populations and should restart. Null when edit detection is degraded.

limitinteger required

The effective page size (the request's limit after clamping to [1, 5000]; default 1000).

snapshotCompleteboolean required

True once ackDB's durable snapshot is complete after this page commits.

maxSeqinteger required

Change-log head captured with this page.

minRetainedSeqinteger required

Earliest retained change sequence.

Changes

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