update_alert
Modify an alert's threshold, evaluation window, notification channels, name, or enabled flag. Alert type cannot be updated—create a new alert to change it.
Instructions
Update an existing alert's settings (PATCH /v1/alerts/:id). alertType (the watched metric type) is immutable — to change it, create a new alert and then delete the old one (completing the alert lifecycle). Threshold / evaluation window / notification channels / name / enabled flag / composite conditions can be partially updated (all fields optional). Example phrasing: "lower the monthly budget alert threshold from $100 to $50" / "add Slack as a notification channel".
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Display name of the alert (1-100 chars, no line breaks). Omit to keep the current value | |
| alertId | Yes | Target alert ID (from list_alerts) | |
| enabled | No | Alert enabled flag. false pauses evaluation (unlike silence, re-enabling requires another PATCH) | |
| conditions | No | Update of the v1.5 multi-condition alert. When specified, the single-metric path is ignored in favor of AND/OR aggregation. Can overwrite either an existing single-metric or multi-condition alert. | |
| filterModel | No | Target model (substring match). Omit to keep the current value; pass an explicit null to reset to all models | |
| channelKinds | No | Notification channel kinds to enable. Omit to keep the current value. Updating together with channelTargets is recommended | |
| sleepMinutes | No | Suppression window for repeated notifications (minutes, 5-10080). Omit to keep the current value | |
| windowMinutes | No | Aggregation window (minutes, 5-43200). Omit to keep the current value | |
| channelTargets | No | Destination object for every kind listed in channelKinds. Omit to keep the current value | |
| filterProvider | No | Target provider. Omit to keep the current value; pass an explicit null to reset to all providers | |
| thresholdValue | No | Threshold (>= 0). Omit to keep the current value |