2016-07-28 09:56:09 -04:00
|
|
|
Purge History API
|
|
|
|
|
=================
|
|
|
|
|
|
|
|
|
|
The purge history API allows server admins to purge historic events from their
|
|
|
|
|
database, reclaiming disk space.
|
|
|
|
|
|
|
|
|
|
Depending on the amount of history being purged a call to the API may take
|
|
|
|
|
several minutes or longer. During this period users will not be able to
|
|
|
|
|
paginate further back in the room from the point being purged from.
|
|
|
|
|
|
|
|
|
|
The API is simply:
|
|
|
|
|
|
|
|
|
|
``POST /_matrix/client/r0/admin/purge_history/<room_id>/<event_id>``
|
|
|
|
|
|
|
|
|
|
including an ``access_token`` of a server admin.
|
2018-02-08 13:44:52 -05:00
|
|
|
|
|
|
|
|
By default, events sent by local users are not deleted, as they may represent
|
|
|
|
|
the only copies of this content in existence. (Events sent by remote users are
|
|
|
|
|
deleted, and room state data before the cutoff is always removed).
|
|
|
|
|
|
|
|
|
|
To delete local events as well, set ``delete_local_events`` in the body:
|
|
|
|
|
|
|
|
|
|
.. code:: json
|
|
|
|
|
|
|
|
|
|
{
|
|
|
|
|
"delete_local_events": True,
|
|
|
|
|
}
|
