Skip to main content
GET
List observed event shapes and rule contract drift
Samples recent events and groups payloads by top-level event type and name. The inventory reports field presence, missing and null counts, observed JSON types, and redacted examples. current_window and baseline_window show drift. The response also compares observed fields with the fields active rules read (referenced_never_observed, observed_unreferenced). Use it to check event.* names before you write conditions, and to investigate fields that disappeared or changed type. warnings never block rule saves or event ingestion. window_days, sample_limit, and as_of control the sample. Pass as_of when you need the same sample again. If payloads were truncated or omitted, payloads_omitted and the window byte-limit fields say so. See Writing rules: Validate a condition.

Authorizations

X-API-Key
string
header
required

API key passed in the X-API-Key header.

Path Parameters

programId
string<uuid>
required

Program ID

Query Parameters

window_days
integer
default:7

Current and baseline window width in days (1-30)

Required range: 1 <= x <= 30
sample_limit
integer
default:50

Maximum events sampled per window (1-100)

Required range: 1 <= x <= 100
as_of
string<date-time>

Exclusive end of the current ingestion-time window (RFC3339; defaults to request time)

Response

Observed shape inventory and drift warnings

as_of
string
Example:

"2026-07-08T00:00:00Z"

baseline_window
object
current_window
object
inventory
object
observed_unreferenced
string[]
Example:
program_id
string<uuid>
Example:

"550e8400-e29b-41d4-a716-446655440000"

referenced_never_observed
string[]
Example:
references
object
warnings
object[]