summary refs log tree commit diff
path: root/docs/admin_api/purge_remote_media.rst
blob: 749ed1b2b9496b65bbcb2ace813fca7cfe516712 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
Purge Remote Media API
======================

The purge remote media API allows server admins to purge old cached remote
media. 

The API is::

    POST /_matrix/client/r0/admin/purge_history/

    {
        "before_ts": <unix_timestamp_in_ms>
    }

Which will remove all cached media that was last accessed before
``<unix_timestamp_in_ms>``.

If the user re-requests purged remote media, synapse will re-request the media
from the originating server.