Update Metric Alert Rule

Replaces the user-mutable fields of an existing rule. Evaluator-owned state (status, last_value, last_evaluated_at, last_triggered_at) is preserved across the update — only the configuration is replaced.

Send the full rule body, not a partial patch. Use the response from Get Alert as the starting point and modify the fields you want to change.

Plan-gated: requires the metric_alerts entitlement (403 without it).

Path parameters

Request body

Same shape as Create. endpoint_uuid is re-resolved on every update; pass an empty string to clear an endpoint scope.

Each channel's secret (a webhook's signing key):

• **** — the placeholder every read answers — keeps the secret saved on the rule: the saved channel of the same type and target, else the saved channel at the same position when it has the same type (its URL was edited). A **** with no saved secret behind it is refused with 400 on notify_channels (see Errors).
• "", or no secret key, removes it.
• Any other value replaces it.

Response (200 OK)

The updated rule. status and other evaluator fields reflect the worker's last cycle, not the update. A channel that has a secret answers "secret": "****".

Deprecated: until the sunset this response also carries the legacy integer id and *_id fields. Don't use them; read uuid and the *_uuid fields.

Errors