How do I delete users from Matrix synapse backend?

Through my droplet console I can add additional users, reset current user passwords, and upgrade element. These are all achieved through a bash script but I am unable to delete users.

Submit an answer

This textbox defaults to using Markdown to format your answer.

You can type !ref in this text area to quickly search our full set of tutorials, documentation & marketplace offerings and insert the link!

Sign In or Sign Up to Answer

These answers are provided by our Community. If you find them useful, show some love by clicking the heart. If you run into issues leave a comment, or add your own answer to help others.

Site Moderator
Site Moderator badge
November 16, 2023

Heya @5a7a4fd77cfb48d78cbaa18641610a,

To delete a user, you actually ‘deactivate’ them via the API. This prevents the user from logging in and removes them from all rooms.

  • Use a command like curl -X POST -H "Authorization: Bearer [YOUR_ACCESS_TOKEN]" -H "Content-Type: application/json" -d '{"erase": true}' "https://[your_matrix_server]/_synapse/admin/v1/deactivate/@username:domain".
  • Replace [YOUR_ACCESS_TOKEN] with your admin user’s access token, [your_matrix_server] with your server’s URL, and @username:domain with the full Matrix ID of the user you want to deactivate.
  • The "erase": true part ensures that the user’s data is also erased, not just deactivated.

Try DigitalOcean for free

Click below to sign up and get $200 of credit to try our products over 60 days!

Sign up

Featured on Community

Get our biweekly newsletter

Sign up for Infrastructure as a Newsletter.

Hollie's Hub for Good

Working on improving health and education, reducing inequality, and spurring economic growth? We'd like to help.

Become a contributor

Get paid to write technical tutorials and select a tech-focused charity to receive a matching donation.

Welcome to the developer cloud

DigitalOcean makes it simple to launch in the cloud and scale up as you grow — whether you're running one virtual machine or ten thousand.

Learn more
DigitalOcean Cloud Control Panel