Sign in

v44

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-0156121143.5 KB

Publish an event into the telemetry stream

Injects an event into the telemetry stream, gated by the active telemetry config. Returns 200 with the assigned envelope when the event is admitted, 204 when the event is filtered (no active session or the event's category is disabled), or 400 on validation failure.

post/telemetry/events

Request body

typestring required

Event type identifier.

category'console' | 'network' | 'page' | 'interaction' | 'control' | 'connection' | 'system' | 'screenshot' | 'captcha' | 'monitor'

Event category. Optional and advisory: for a known event type the server assigns the category authoritatively and ignores this field. It is only used for unknown custom types, where it is required.

{"stackTrail":"components:schemas:PublishEventRequest:properties:data","oasType":"schema","type":"unknown","description":"Telemetry event payload."}

Response

Event published; envelope carries the assigned sequence.

seqinteger required

Process-monotonic sequence number assigned across the lifetime of the server. Use with Last-Event-ID to resume the SSE stream from this point.