History API

Query state changes and decisions.

GET /v1/history/events?session_id=sess_abc123&type=gate_evaluation&from=2026-09-15T00:00:00Z&limit=10
Authorization: Bearer sk_live_...

Filters

ParameterDescription
session_idLimit to one session
typeEvent type, for example gate_evaluation
fromOnly events at or after this time
limitPage size
cursorContinue from a previous page

History is append-only. Events are never edited or deleted, which is what makes them usable as evidence. See Audit trail and receipts.

Last reviewed October 2026Suggest a change