v3

OpenAPI 3.1.02026-07-31350397683.8 KB

Alerts

Get Alert Results

Get an alert's fired results (events).

Config is read from the unified alerts table; events are read from ClickHouse (observability_alert_events / simulation_alerts_history) by the alert's source_scope. Each result resolves to the entity that caused it: for simulation, the experiment (simulation) + run; for observability, the call. Newest-first, page-paginated; pass source to restrict to one data source.

get/v1/alerts/{alert_id}/results

Path parameters

alert_idstring uuid required

Query parameters

source'simulation' | 'observability'

Filterable sources for the results endpoint.

Deliberately excludes AlertEventSource.UNKNOWN: it is a classification outcome, not a valid filter, and accepting it would silently return unfiltered results.

Filter results by source: 'simulation' or 'observability'

page_sizeinteger

Max results per page

pageinteger

Page number (1-based)

Headers

X-API-Keystring required

API key required to authenticate requests.

Response

Successful Response

alert_idstring required

ID of the alert

source_scopestring required

Configured source scope of the alert

total_countinteger required

Total number of events matching the filter across all pages

pageinteger required

Current page (1-based)

page_sizeinteger required

Requested number of items per page

items_in_pageinteger required

Actual number of items on this page

total_pagesinteger required

Total number of pages