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
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.