Update Alert Rule
update_alert_ruleReconfigure or toggle one alert rule, predefined or custom.
ref decides which: a kind name (consistent_error_pattern, silent_failure,
tool_loop) addresses the predefined rule of that kind; a uuid addresses a
custom rule. Get either from list_alert_rules.
Only what you pass changes. Turning a rule off stops detection, not just notification — gaps in history are permanent and nothing backfills them.
The two rule shapes take DIFFERENT settings, and mixing them is refused with a message naming the right one:
a predefined rule has named integer knobs -> pass
configa custom rule has metric thresholds -> pass
rules(+window_minutes)
ref: the rule's kind or uuid.
enabled: turn detection on or off.
rca_enabled: turn root-cause analysis on or off for this rule.
name: rename a custom rule (predefined rules take their name from their kind).
config: for a PREDEFINED rule only — its named knobs, e.g.
{"min_errored_spans": 10}. consistent_error_pattern takes
window_minutes, min_errored_spans, min_distinct_traces; silent_failure
takes window_minutes; tool_loop takes window_minutes,
min_identical_calls. Call describe_alert_catalog for the bounds.
rules: for a CUSTOM rule only — replace its thresholds. Replaces the whole
list, so pass window_minutes with it.
window_minutes: the window. For a custom rule it is part of the replaced
config, so pass rules too; for a predefined rule put it in config.
filters: for a CUSTOM rule only — replace its filters. Replaces the whole
list. Same shape and the same verbatim-value rule as create_alert_rule.
channel_ids: change where the rule delivers. Needs channels:manage. An empty
list does NOT silence the rule — it re-points it at the region's default
webhook. To stop notifications, set enabled to false.
workspace: optional workspace id, name, or org-name/workspace-name when the
same name occurs in two of your orgs (defaults to your default).
Example:
Turn off the tool loop alert.
{ "name": "update_alert_rule", "arguments": { "ref": "tool_loop", "enabled": false } }Example:
Make the error pattern alert less noisy — 10 errors, not 3.
{ "name": "update_alert_rule", "arguments": {
"ref": "consistent_error_pattern",
"config": { "min_errored_spans": 10 }
} }Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ref | Yes | ||
| name | No | ||
| rules | No | ||
| config | No | ||
| enabled | No | ||
| filters | No | ||
| workspace | No | ||
| channel_ids | No | ||
| rca_enabled | No | ||
| window_minutes | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |