---
title: "Changes to Update an alert rule"
method: PATCH
path: "/alert-rules/{rule_id}"
---

# Changes to Update an alert rule

`PATCH /alert-rules/{rule_id}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 2 revisions.

- **2026-10-19** `a6e1ec0dec82`: 9 breaking, 15 warning, 14 info

## Changes

- **2026-10-19** `a6e1ec0dec82`: 9 breaking, 15 warning, 14 info
  - added the new path request parameter `rule_id`
  - request body became required
  - the `market_ids/items/` request property's minLength was increased from `0` to `1`
  - the `recipient_ids/items/` request property's minLength was increased from `0` to `1`
  - removed `subschema #1, subschema #2` from the `target_ids/items/` request property `oneOf` list
  - the response's body type changed from `object` to no type for status `200`
  - removed the required property `condition_type` from the response with the `200` status
  - removed the required property `id` from the response with the `200` status
  - removed the required property `name` from the response with the `200` status
  - the `market_ids/items/` request property's maxLength was set to `120`
  - the `recipient_ids/items/` request property's maxLength was set to `120`
  - removed the optional property `change_pct` from the response with the `200` status
  - removed the optional property `channels` from the response with the `200` status
  - removed the optional property `competitor_domain` from the response with the `200` status
  - removed the optional property `drop_positions` from the response with the `200` status
  - removed the optional property `enabled` from the response with the `200` status
  - removed the optional property `market_ids` from the response with the `200` status
  - removed the optional property `recipient_ids` from the response with the `200` status
  - removed the optional property `serp_feature` from the response with the `200` status
  - removed the optional property `severity` from the response with the `200` status
  - removed the optional property `target_ids` from the response with the `200` status
  - removed the optional property `target_type` from the response with the `200` status
  - removed the optional property `threshold_position` from the response with the `200` status
  - removed the optional property `top_n` from the response with the `200` status
  - the endpoint scheme security `AppOAuth` was added to the API
  - added the new optional `header` request parameter `Idempotency-Key`
  - the `channels` request property default value `` was added
  - the `enabled` request property default value `true` was added
  - the `target_ids` request property default value `` was added
  - the `target_type` request property default value `all` was added
  - added the new `push` enum value to the request property `channels/items/`
  - added `subschema #1, subschema #2` to the `target_ids/items/` request property `oneOf` list
  - added `subschema #1, subschema #2, subschema #3, subschema #4` to the response body `anyOf` list for the response status `200`
  - media type `application/json` was changed to a more specific media type `application/problem+json` for the response status `400`
  - media type `application/json` was changed to a more specific media type `application/problem+json` for the response status `401`
  - media type `application/json` was changed to a more specific media type `application/problem+json` for the response status `403`
  - media type `application/json` was changed to a more specific media type `application/problem+json` for the response status `404`
  - media type `application/json` was changed to a more specific media type `application/problem+json` for the response status `429`

---

[Operation](https://skmtc.dev/bisibility/apis/bisibility-public-api/docs/alert-rules/:rule_id/patch.md) · [API](https://skmtc.dev/bisibility/apis/bisibility-public-api.md) · [Page](https://skmtc.dev/bisibility/apis/bisibility-public-api/changes/alert-rules/:rule_id/patch)