Skip to content

Commit 3b248c5

Browse files
JohennesHalf-Shot
andauthored
Update proposals/4155-invite-filtering.md
Co-authored-by: Will Hunt <github@half-shot.uk>
1 parent 2f17aa7 commit 3b248c5

1 file changed

Lines changed: 16 additions & 1 deletion

File tree

proposals/4155-invite-filtering.md

Lines changed: 16 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -50,7 +50,22 @@ apply the following order:
5050
3. Otherwise, allow.
5151

5252
The semantics of "ignore" and "block" follow [MSC4283] which means ignoring hides the invite with no
53-
feedback to the inviter whereas blocking rejects (or refuses, in the case of servers) the invite.
53+
feedback to the invite whereas blocking rejects (or refuses, in the case of servers) the invite.
54+
55+
When blocking an inviter, the server must respond to the following endpoints with an error:
56+
57+
- `PUT /_matrix/federation/(v1|v2)/invite/{roomId}/{eventId}`
58+
- `POST /_matrix/client/v3/rooms/{roomId}/invite`
59+
- `POST /_matrix/client/v3/createRoom` (checking the `invite` list)
60+
- `PUT /_matrix/client/v3/rooms/{roomId}/state/m.room.member/{stateKey}` (for invite membership)
61+
62+
The error SHOULD be `M_INVITE_BLOCKED` with a HTTP 403 status code.
63+
64+
When ignoring an invite, these endpoints MUST handle an invite normally as if accepted. However, the server MUST not include the invite down client synchronization endpoints such as `GET /_matrix/client/v3/sync` or MSC4186's sliding sync endpoint. In addition, these invites MUST be ignored when calculating push notifications.
65+
66+
Otherwise, all other endpoints (such as `GET /_matrix/client/v3/rooms/{roomId}/state`) should work as before.
67+
68+
Servers are not expected to process these rules for appservice users when calculating events to send down `PUT /_matrix/app/v1/transactions`. Appservices are not expected to be run directly by client users, and should be able to handle their own spam prevention.
5469

5570
The semantics and order of evaluation enable a number of use cases, for instance:
5671

0 commit comments

Comments
 (0)