2018-01-31 08:15:59 -07:00
|
|
|
# List all media in a room
|
|
|
|
|
|
|
|
This API gets a list of known media in a room.
|
|
|
|
|
|
|
|
The API is:
|
|
|
|
```
|
2019-05-01 08:18:58 -06:00
|
|
|
GET /_synapse/admin/v1/room/<room_id>/media
|
2018-01-31 08:15:59 -07:00
|
|
|
```
|
|
|
|
including an `access_token` of a server admin.
|
|
|
|
|
|
|
|
It returns a JSON body like the following:
|
|
|
|
```
|
|
|
|
{
|
|
|
|
"local": [
|
|
|
|
"mxc://localhost/xwvutsrqponmlkjihgfedcba",
|
|
|
|
"mxc://localhost/abcdefghijklmnopqrstuvwx"
|
|
|
|
],
|
|
|
|
"remote": [
|
|
|
|
"mxc://matrix.org/xwvutsrqponmlkjihgfedcba",
|
|
|
|
"mxc://matrix.org/abcdefghijklmnopqrstuvwx"
|
|
|
|
]
|
|
|
|
}
|
|
|
|
```
|
2019-12-03 11:20:39 -07:00
|
|
|
|
|
|
|
# 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.
|