From c8b7baa33290f1ab9b3cea4ebd89778b0d92bcd7 Mon Sep 17 00:00:00 2001
From: Travis Ralston <travpc@gmail.com>
Date: Wed, 4 Sep 2019 20:48:20 -0600
Subject: [PATCH] Clarify admin docs for purging

---
 docs/admin.md | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/docs/admin.md b/docs/admin.md
index 666bb994..f45568c0 100644
--- a/docs/admin.md
+++ b/docs/admin.md
@@ -16,17 +16,19 @@ This will delete remote media from the file store that was downloaded before the
 
 Any remote media that is deleted and requested by a user will be downloaded again.
 
+This endpoint is only available to repository administrators.
+
 #### Purge quarantined media
 
 URL: `POST /_matrix/media/unstable/admin/purge/quarantined?access_token=your_access_token`
 
-This will delete all media that has previously been quarantined, local or remote.
+This will delete all media that has previously been quarantined, local or remote. If called by a homeserver administrator (who is not a repository administrator), only content quarantined for their domain will be purged.
 
 #### Purge individual record
 
 URL: `POST /_matrix/media/unstable/admin/purge/<server>/<media id>?access_token=your_access_token`
 
-This will delete the media record, regardless of it being local or remote.
+This will delete the media record, regardless of it being local or remote. Can be called by homeserver administrators and the uploader to delete it.
 
 ## Quarantine media
 
-- 
GitLab