Werk #22089: REST-API: Order notification rules

Component

REST API

Title

REST-API: Order notification rules

Date

Aug 3, 2026

Level

Trivial Change

Class

New Feature

Compatibility

Compatible - no manual interaction needed

Checkmk versions & editions

3.0.0b1 Not yet released	Checkmk Community, Checkmk Pro, Checkmk Ultimate, Checkmk Cloud, Checkmk Ultimate MT

You can now change the position of a notification rule via the REST-API, and see where a rule sits in the chain.

Move a notification rule

The new endpoint POST /objects/notification_rule/{rule_id}/actions/move/invoke moves a single rule within the notification rule chain. Pick one of four positions in the request body:

{"position": "top_of_list"}
{"position": "bottom_of_list"}
{"position": "before_specific_rule", "rule_id": "<other rule id>"}
{"position": "after_specific_rule", "rule_id": "<other rule id>"}

The endpoint answers with 204 No Content. Read the rule again to see its new position.

See the position of a rule

All notification rule responses now carry a rule_index extension next to rule_config:

{
    "id": "5425d554-5741-4bbf-b907-1a391dfab5bb",
    "extensions": {
        "rule_index": 2,
        "rule_config": {}
    }
}

Notification rules are evaluated from top to bottom, so a lower rule_index means the rule is checked earlier. Newly created rules are still appended to the end of the chain, and updating a rule leaves its position untouched.

To the list of all Werks