Filip/matrix-spec
1
0
Fork 0
mirror of https://github.com/matrix-org/matrix-spec synced 2025-12-20 16:38:37 +01:00
Code Issues Actions 3 Packages Projects Releases Wiki Activity

Push rule IDs are globally unique within their kind (#2214)

Browse source
This commit is contained in:
Johannes Marbach 2025-09-26 12:02:36 +02:00 committed by GitHub
parent d4d31a8894
commit 21109b4d5b
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
2 changed files with 4 additions and 5 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

1
changelogs/client_server/newsfragments/2214.clarification Normal file
View file

@ -0,0 +1 @@
Push rule IDs are globally unique within their kind.

8
content/client-server-api/modules/push.md
View file

@ -83,7 +83,7 @@ Push Ruleset
: A push ruleset *scopes a set of rules according to some criteria*. For : 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 example, some rules may only be applied for messages from a particular
sender, a particular room, or by default. The push ruleset contains the sender, a particular room, or by default. The push ruleset contains the
entire set of scopes and rules. entire set of rules.
#### Push 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 event should be passed onto a push gateway and *how* the notification
should be presented. There are different "kinds" of push rules and each 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 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 `rule_id`. The `rule_id` is a unique string within the kind of rule.
its' scope: `rule_ids` do not need to be unique between rules of the Rules may have extra keys depending on the value of `kind`.
same kind on different devices. 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: The different `kind`s of rule, in the order that they are checked, are: