Events & Signals

Events are the raw signals emitted by FORG adapters — each represents a single AI tool call with its response metadata. FORG does not expose a top-level/events collection. Signals are scoped to the session that produced them and are read through the sessions API.

Per-session signals

Retrieve a session and its governance signals (interventions) via the session sub-resource:

GET /api/v1/sessions/{sessionId}
GET /api/v1/sessions/{sessionId}/interventions
Authorization: Bearer forg_live_...

See the Sessions API for the session object and the interventions sub-resource, which returns the policy/gate signals recorded during that session.

Aggregated usage

For rolled-up usage and cost across sessions (rather than individual signals), use the Usage & Reports API.

Authentication

All endpoints authenticate with an API key: Authorization: Bearer forg_live_.... See Authentication.