From 21109b4d5b981480650dc4d94e55f3dca8f2efc7 Mon Sep 17 00:00:00 2001 From: Johannes Marbach Date: Fri, 26 Sep 2025 12:02:36 +0200 Subject: [PATCH] Push rule IDs are globally unique within their kind (#2214) --- changelogs/client_server/newsfragments/2214.clarification | 1 + content/client-server-api/modules/push.md | 8 +++----- 2 files changed, 4 insertions(+), 5 deletions(-) create mode 100644 changelogs/client_server/newsfragments/2214.clarification diff --git a/changelogs/client_server/newsfragments/2214.clarification b/changelogs/client_server/newsfragments/2214.clarification new file mode 100644 index 00000000..50121eaa --- /dev/null +++ b/changelogs/client_server/newsfragments/2214.clarification @@ -0,0 +1 @@ +Push rule IDs are globally unique within their kind. diff --git a/content/client-server-api/modules/push.md b/content/client-server-api/modules/push.md index a8327b40..1b7ecc4d 100644 --- a/content/client-server-api/modules/push.md +++ b/content/client-server-api/modules/push.md @@ -83,7 +83,7 @@ Push Ruleset : A push ruleset *scopes a set of rules according to some criteria*. For example, some rules may only be applied for messages from a particular sender, a particular room, or by default. The push ruleset contains the - entire set of scopes and rules. + entire set of rules. #### Push Rules @@ -91,10 +91,8 @@ A push rule is a single rule that states under what *conditions* an event should be passed onto a push gateway and *how* the notification should be presented. There are different "kinds" of push rules and each rule has an associated priority. Every push rule MUST have a `kind` and -`rule_id`. The `rule_id` is a unique string within the kind of rule and -its' scope: `rule_ids` do not need to be unique between rules of the -same kind on different devices. Rules may have extra keys depending on -the value of `kind`. +`rule_id`. The `rule_id` is a unique string within the kind of rule. +Rules may have extra keys depending on the value of `kind`. The different `kind`s of rule, in the order that they are checked, are: