idstring required
Unique identifier for the alert
descriptionstring nullable
is_enabledboolean required
Whether the alert is enabled
organization_idstring required
entity_type'standard_metric' | 'custom_goal' | 'custom_metric' | 'metadata_field' | 'system_failure' required
Enum representing the entity types for alerts.
entity_fieldstring required
The specific field/metric being monitored
operator'equals' | 'not_equals' | 'greater_than' | 'less_than' | 'greater_than_or_equal' | 'less_than_or_equal' | 'contains' | 'not_contains' required
Enum representing the comparison operators for alerts.
comparison_valuestring required
last_triggered_atstring date-time nullable
When the alert was last triggered
trigger_countinteger required
Number of times triggered
created_bystring nullable
User who created the alert
applies_to_all_agentsboolean required
Whether the alert applies to all agents
simulation_idinteger nullable
Optional experiments.id (simulation) this alert is scoped to
evaluation_scopestring nullable
How this alert is evaluated. Only 'per_simulation_run' is supported.
aggregationstring nullable
Aggregation mode used to compute the per-run metric value from test results within the run.
created_atstring date-time required
When the alert was created
updated_atstring date-time nullable
When the alert was last updated
updated_bystring nullable
User who last updated the alert
threshold_time_intervalinteger nullable required
For observability source_scope: time window in seconds. For simulation source_scope: K = number of recent completed runs.
min_eventsinteger nullable required
The minimum number of events for the alert. NULL for simulation alerts.
min_events_typestring
Whether min_events is an absolute count or a percentage
in_alertboolean required
Whether the alert is in alert
source_scopestring
Which data source fires this alert: 'all', 'observability', or 'simulation'
simulation_namestring nullable
Name of the simulation (experiment) this alert is scoped to, if any
sample_sizeinteger nullable
Most recent N conversations the alert is evaluated over; NULL = time window