---
title: "Changes to Create an alert rule"
method: POST
path: "/projects/{project_id}/alert-rules"
---

# Changes to Create an alert rule

`POST /projects/{project_id}/alert-rules`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 2 revisions.

- **2026-10-19** `a6e1ec0dec82`: 6 breaking, 2 warning, 15 info

## Changes

- **2026-10-19** `a6e1ec0dec82`: 6 breaking, 2 warning, 15 info
  - added the new path request parameter `project_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
  - removed the success response with the status `200`
  - the `market_ids/items/` request property's maxLength was set to `120`
  - the `recipient_ids/items/` request property's maxLength was set to `120`
  - the endpoint scheme security `AppOAuth` was added to the API
  - added the new optional `header` request parameter `Idempotency-Key`
  - added the new optional request property `rule_id`
  - 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
  - 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 success response with the status `201`

---

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