Replay API
Pull windows, run diffs and start bisects over HTTP — the same calls the CLI makes.
Authentication
Send a workspace token as a bearer header. Tokens are read-only by default; a write scope is needed only for ingest.
Authorization: Bearer fw_live_…
Pull a window
GET /v1/services/{service}/windows?from=2026-08-25T02:00Z&to=2026-08-25T03:00Z
Returns newline-delimited JSON, gzip-compressed, one event per line in recorded order. Windows up to 24 hours are returned in one response; longer ranges are paged.
Diff two windows
POST /v1/diffs
{ "service": "checkout-api", "a": "2026-08-26T02:00Z/1h", "b": "2026-08-25T02:00Z/1h", "key": "order_id" }
The response lists keys whose folded state differs, with the first offset of divergence for each.
Start a bisect
POST /v1/bisects
{ "service": "checkout-api", "bad": "2026-08-25T02:00Z/1h", "good": "2026-08-26T02:00Z/1h", "key": "order_id" }
Bisects run asynchronously; poll the returned URL or register a webhook. Typical hours finish in under ten seconds.
Limits
Replays, diffs and bisects are not metered. The API allows 20 requests per second per token.