GET /replay endpoint is your primary tool for state catch-up and crash recovery. When an agent restarts with a stale local state, you call this endpoint with the last sequence number it successfully processed — the server responds with all subsequent replication chunks in chronological order, up to a maximum of 1,000 rows. You apply those chunks locally to bring the agent back to the current confirmed head without re-downloading full snapshots.
Request
Query Parameters
integer
required
Retrieve all replication log entries with sequence numbers strictly greater than this value. Pass the last sequence number your agent successfully applied. Use
since=0 to replay from the very beginning.The
since parameter is required. Omitting it returns a 400 missing_since_param error. The response is capped at 1,000 chunks per call — if the gap is larger, paginate by using the highest sequence_number in the response as the next since value.Response
200 OK
array
Ordered list of replication chunks with sequence numbers greater than
since.integer
Monotonic sequence number of this chunk.
string
SHA-256 hash of the packed chunk block, for local integrity verification.
string
Base64-encoded ciphertext of the chunk in
IV || ciphertext form.string
Merkle root recorded when this chunk was originally submitted.
string
ISO-8601 timestamp of when this chunk was persisted.
integer
Total number of chunks returned in this response.