From 012736ff070573fa15611a178e83421f4998abb7 Mon Sep 17 00:00:00 2001
From: Andrew Morgan <andrew@amorgan.xyz>
Date: Tue, 22 Sep 2020 15:30:44 +0100
Subject: [PATCH] Deprecation warning for synapse admin api being accessible
 under /_matrix

---
 CHANGES.md | 14 +++++++++++++-
 1 file changed, 13 insertions(+), 1 deletion(-)

diff --git a/CHANGES.md b/CHANGES.md
index 5a846daa4d..bac099e9b5 100644
--- a/CHANGES.md
+++ b/CHANGES.md
@@ -1,7 +1,19 @@
 Synapse 1.20.0 (2020-09-22)
 ===========================
 
-No significant changes.
+No significant changes since v1.20.0rc5.
+
+Removal warning
+---------------
+
+Historically, the [Synapse Admin
+API](https://github.com/matrix-org/synapse/tree/master/docs) has been
+accessible under the `/_matrix/client/api/v1/admin`,
+`/_matrix/client/unstable/admin`, `/_matrix/client/r0/admin` and
+`/_synapse/admin` prefixes. In a future release, we will soon be dropping
+support for accessing Synapse's Admin API using the `/_matrix/client/*`
+prefixes. This is to help make locking down external access to the Admin API
+endpoints easier for homeserver admins.
 
 
 Synapse 1.20.0rc5 (2020-09-18)