From 5db3eec5bcd3bc2b92c44e784264dfb5abaf89f6 Mon Sep 17 00:00:00 2001
From: Quentin Gliech <quenting@element.io>
Date: Thu, 13 Jun 2024 15:49:00 +0200
Subject: [PATCH] Clarify that MSC4151 is enabled on matrix.org (#17296)
This clarifies in the comments that the MSC is being used in matrix.org
See #17270
---
changelog.d/17296.feature | 1 +
synapse/rest/client/reporting.py | 10 +++++++++-
2 files changed, 10 insertions(+), 1 deletion(-)
create mode 100644 changelog.d/17296.feature
diff --git a/changelog.d/17296.feature b/changelog.d/17296.feature
new file mode 100644
index 0000000000..4ea5e7be85
--- /dev/null
+++ b/changelog.d/17296.feature
@@ -0,0 +1 @@
+Add support for the unstable [MSC4151](https://github.com/matrix-org/matrix-spec-proposals/pull/4151) report room API.
diff --git a/synapse/rest/client/reporting.py b/synapse/rest/client/reporting.py
index a95b83b14d..4eee53e5a8 100644
--- a/synapse/rest/client/reporting.py
+++ b/synapse/rest/client/reporting.py
@@ -107,7 +107,15 @@ class ReportEventRestServlet(RestServlet):
class ReportRoomRestServlet(RestServlet):
- # https://github.com/matrix-org/matrix-spec-proposals/pull/4151
+ """This endpoint lets clients report a room for abuse.
+
+ Whilst MSC4151 is not yet merged, this unstable endpoint is enabled on matrix.org
+ for content moderation purposes, and therefore backwards compatibility should be
+ carefully considered when changing anything on this endpoint.
+
+ More details on the MSC: https://github.com/matrix-org/matrix-spec-proposals/pull/4151
+ """
+
PATTERNS = client_patterns(
"/org.matrix.msc4151/rooms/(?P<room_id>[^/]*)/report$",
releases=[],
--
GitLab