---
title: "Changes to Create Alert Rule Route"
method: POST
path: "/api/v1/alert-rules"
---

# Changes to Create Alert Rule Route

`POST /api/v1/alert-rules`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 5 of 20 revisions.

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

## Changes

- **2026-10-04** `b475b750a0b7`: 5 info
  - added the new `fallback_rate` enum value to the request property `metric/anyOf[subschema #1]/`
  - 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]/`
  - added the new `provider_failure_rate` enum value to the request property `metric/anyOf[subschema #1]/`
  - added the new `provider_id` enum value to the request property `group_by/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`: 2 breaking, 1 warning, 3 info
  - removed the enum value `proxy_id` of the request property `group_by/anyOf[subschema #1]/`
  - removed the required property `proxy_id` from the response with the `201` status
  - removed the request property `proxy_id`
  - added the new optional request property `agent_id`
  - added the new `agent_id` enum value to the request property `group_by/anyOf[subschema #1]/`
  - added the required property `agent_id` to the response with the `201` status
- **2026-08-31** `18ce94490752`: 1 breaking, 10 info
  - request property `group_by/anyOf[subschema #1]/` was restricted to a list of enum values
  - added the new optional request property `aggregation`
  - the `` request property const value `proxy_id` was removed
  - 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 `guardrail_name` enum value to the request property `group_by/anyOf[subschema #1]/`
  - added the new `policy_block_rate` enum value to the request property `metric/anyOf[subschema #1]/`
  - added the new `policy_redact` enum value to the request property `trigger_type/anyOf[subschema #1]/`
  - added the new `policy_rule` enum value to the request property `group_by/anyOf[subschema #1]/`
  - added the new `proxy_id` enum value to the request property `group_by/anyOf[subschema #1]/`
  - added the required property `aggregation` to the response with the `201` status
- **2026-08-25** `e63bfe8e38b4`: 5 breaking, 22 info
  - removed the enum value `high_intent_score` of the request property `trigger_type`
  - removed the enum value `high_latency` of the request property `trigger_type`
  - removed the enum value `policy_block` of the request property `trigger_type`
  - removed the enum value `policy_escalate` of the request property `trigger_type`
  - response property `trigger_type` list-of-types was widened by adding types `null` to media type `application/json` of response `201`
  - added the new optional request property `cooldown_seconds`
  - added the new optional request property `filters`
  - added the new optional request property `group_by`
  - added the new optional request property `kind`
  - added the new optional request property `metric`
  - 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`
  - the request property `trigger_type` became optional
  - request property `trigger_type` list-of-types was widened by adding types `null` to media type `application/json`
  - added the required property `cooldown_seconds` to the response with the `201` status
  - added the required property `created_by` to the response with the `201` status
  - added the required property `filters` to the response with the `201` status
  - added the required property `group_by` to the response with the `201` status
  - added the required property `kind` to the response with the `201` status
  - added the required property `metric` to the response with the `201` status
  - added the required property `min_samples` to the response with the `201` status
  - added the required property `operator` to the response with the `201` status
  - added the required property `severity` to the response with the `201` status
  - added the required property `updated_at` to the response with the `201` status
  - added the required property `window_seconds` to the response with the `201` status

---

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