write some docs for the quarantine_media api (#6458)

pull/6468/head
Richard van der Hoff 2019-12-03 18:20:39 +00:00 committed by GitHub
parent fdec84aa42
commit 620f98b65b
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 18 additions and 0 deletions

1
changelog.d/6458.doc Normal file
View File

@ -0,0 +1 @@
Write some docs for the quarantine_media api.

View File

@ -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.