summary refs log tree commit diff
path: root/docs/admin_api/media_admin_api.md
diff options
context:
space:
mode:
authorRichard van der Hoff <1389908+richvdh@users.noreply.github.com>2019-12-03 18:20:39 +0000
committerGitHub <noreply@github.com>2019-12-03 18:20:39 +0000
commit620f98b65b43404ea6bf99f5907170de72707f8a (patch)
tree95d8c5cc290bde6998597eacd6c79efa0ce9d456 /docs/admin_api/media_admin_api.md
parentAdd benchmarks for structured logging performance (#6266) (diff)
downloadsynapse-620f98b65b43404ea6bf99f5907170de72707f8a.tar.xz
write some docs for the quarantine_media api (#6458)
Diffstat (limited to 'docs/admin_api/media_admin_api.md')
-rw-r--r--docs/admin_api/media_admin_api.md17
1 files changed, 17 insertions, 0 deletions
diff --git a/docs/admin_api/media_admin_api.md b/docs/admin_api/media_admin_api.md
index 5e9f8e5d84..8b3666d5f5 100644
--- a/docs/admin_api/media_admin_api.md
+++ b/docs/admin_api/media_admin_api.md
@@ -21,3 +21,20 @@ It returns a JSON body like the following:
     ]
 }
 ```
+
+# Quarantine media in a room
+
+This API 'quarantines' all the media in a room.
+
+The API is:
+
+```
+POST /_synapse/admin/v1/quarantine_media/<room_id>
+
+{}
+```
+
+Quarantining media means that it is marked as inaccessible by users. It applies
+to any local media, and any locally-cached copies of remote media.
+
+The media file itself (and any thumbnails) is not deleted from the server.