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

# Changes to Delete an alert rule

`DELETE /alert-rules/{rule_id}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 2 revisions.

- **2026-10-19** `a6e1ec0dec82`: 4 breaking, 13 warning, 8 info

## Changes

- **2026-10-19** `a6e1ec0dec82`: 4 breaking, 13 warning, 8 info
  - added the new path request parameter `rule_id`
  - 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
  - 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`
  - 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`
  - added the required property `deleted` to the response with the `200` status

---

[Operation](https://skmtc.dev/bisibility/apis/bisibility-public-api/docs/alert-rules/:rule_id/delete.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/delete)