---
title: "Changes to Update Alert Rule Route"
method: PATCH
path: "/api/v1/alert-rules/{rule_id}"
---

# Changes to Update Alert Rule Route

`PATCH /api/v1/alert-rules/{rule_id}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 5 of 20 revisions.

- **2026-10-04** `b475b750a0b7`: 2 info
- **2026-10-04** `2f4b4b338b8f`: 1 info
- **2026-09-27** `b20a3bdd6219`: 1 breaking, 1 warning, 2 info
- **2026-08-31** `18ce94490752`: 5 info
- **2026-08-25** `e63bfe8e38b4`: 1 breaking, 20 info

## Changes

- **2026-10-04** `b475b750a0b7`: 2 info
  - added the new `fallback_served` enum value to the request property `trigger_type/anyOf[subschema #1]/`
  - added the new `fallbacks_exhausted` enum value to the request property `trigger_type/anyOf[subschema #1]/`
- **2026-10-04** `2f4b4b338b8f`: 1 info
  - added the new `compliance_check_failing` enum value to the request property `trigger_type/anyOf[subschema #1]/`
- **2026-09-27** `b20a3bdd6219`: 1 breaking, 1 warning, 2 info
  - removed the required property `proxy_id` from the response with the `200` status
  - removed the request property `proxy_id`
  - added the new optional request property `agent_id`
  - added the required property `agent_id` to the response with the `200` status
- **2026-08-31** `18ce94490752`: 5 info
  - added the new optional request property `aggregation`
  - added the new `guardrail_block` enum value to the request property `trigger_type/anyOf[subschema #1]/`
  - added the new `guardrail_escalate` enum value to the request property `trigger_type/anyOf[subschema #1]/`
  - added the new `policy_redact` enum value to the request property `trigger_type/anyOf[subschema #1]/`
  - added the required property `aggregation` to the response with the `200` status
- **2026-08-25** `e63bfe8e38b4`: 1 breaking, 20 info
  - response property `trigger_type` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - added the new optional request property `cooldown_seconds`
  - added the new optional request property `min_samples`
  - added the new optional request property `operator`
  - added the new optional request property `severity`
  - added the new optional request property `window_seconds`
  - added the new `run_error` enum value to the request property `trigger_type/anyOf[subschema #1]/`
  - added the new `turn_blocked` enum value to the request property `trigger_type/anyOf[subschema #1]/`
  - added the new `turn_error` enum value to the request property `trigger_type/anyOf[subschema #1]/`
  - added the new `turn_escalated` enum value to the request property `trigger_type/anyOf[subschema #1]/`
  - added the required property `cooldown_seconds` to the response with the `200` status
  - added the required property `created_by` to the response with the `200` status
  - added the required property `filters` to the response with the `200` status
  - added the required property `group_by` to the response with the `200` status
  - added the required property `kind` to the response with the `200` status
  - added the required property `metric` to the response with the `200` status
  - added the required property `min_samples` to the response with the `200` status
  - added the required property `operator` to the response with the `200` status
  - added the required property `severity` to the response with the `200` status
  - added the required property `updated_at` to the response with the `200` status
  - added the required property `window_seconds` to the response with the `200` status

---

[Operation](https://skmtc.dev/xenovia/apis/controlplane/docs/api/v1/alert-rules/:rule_id/patch.md) - [API](https://skmtc.dev/xenovia/apis/controlplane.md) - [Page](https://skmtc.dev/xenovia/apis/controlplane/changes/api/v1/alert-rules/:rule_id/patch)