Synapse: Delete a room (Admin API)

[rxl881]

Description:

Server admins are requesting a way to "delete rooms" and it would be good to create some tooling to help with this.

It is possible that this could just be a call to the "room shutdown" API (currently undocumented?) followed by a call to "room purge" admin API? But it would be good to know if this is the correct way to be doing so, and is probably beneficial to combine it in to a single API call?

[richvdh]

"room shutdown" API (currently undocumented?)

https://github.com/matrix-org/synapse/issues/4784

I really wish people wouldn't write APIs without documenting them.

[vapaa]

is there any progress on this topic?

[neilisfragile]

Impl here https://github.com/matrix-org/synapse/pull/2291
Doc'd here https://github.com/matrix-org/synapse/pull/6541

[aaronraimist]

@neilisfragile wasn't the request here for a new API that would combine the room shutdown API and the purge room API into one request?

[neilisfragile]

@aaronraimist good point, thanks for the catch.

[awesome-manuel]

The API should be DELETE /_synapse/admin/v1/rooms/<room-id>
Internally the API should:

• Kick all Users from this room
• Purge room content
• Remove room

See also https://github.com/matrix-org/synapse/pull/7317