Update an alert rule
Partially updates a rule. Only the supplied fields change. Changing parameters bumps the rule’s version and archives the previous version. To change channels, use PUT /:rule_id/channels.
Authorizations
Authorization method required to allow user to access the api endpoints.
Path Parameters
The alert rule id.
"a1b2c3d4-e5f6-7890-abcd-ef1234567890"
Body
Display name for the rule.
255"High gas on eth"
Severity label for the rule.
255"high"
Whether the rule is enabled.
true
Replacement parameter values, as a { field: value } object (arrays are normalized to an object on write). Changing this bumps the rule's version and archives the previous version.
Response
"a1b2c3d4-e5f6-7890-abcd-ef1234567890"
"workspace-123"
"GasPressure"
"high"
BLOCK, TICK "BLOCK"
true
Incremented each time the rule parameters change. Starts at 1.
1
"2026-05-14T12:00:00.000Z"
"2026-05-14T12:00:00.000Z"
"High gas on eth"
"eth"
"alert-runner-eth-v2"