From eeda9586bebfe7265f92ab4f1daa4d8ddc894eb9 Mon Sep 17 00:00:00 2001
From: Andrew Morgan <andrew@amorgan.xyz>
Date: Tue, 17 Aug 2021 18:18:23 +0100
Subject: [PATCH] Add an entry to docs/upgrade.md to reflect the change

---
 docs/upgrade.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/docs/upgrade.md b/docs/upgrade.md
index 1c459d8e2b64..99e32034c8e4 100644
--- a/docs/upgrade.md
+++ b/docs/upgrade.md
@@ -123,6 +123,12 @@ for more information and examples.
 
 We plan to remove support for these settings in October 2021.
 
+## `/_synapse/admin/v1/users/{userId}/media` must be handled by media workers
+
+The [media repository worker documentation](https://matrix-org.github.io/synapse/latest/workers.html#synapseappmedia_repository)
+has been updated to reflect that calls to `/_synapse/admin/v1/users/{userId}/media`
+must now be handled by media repository workers. This is due to the new `DELETE` method
+of this endpoint modifying the media store.
 
 # Upgrading to v1.39.0