* Clarify how to authenticate
* path params are not the same thing as query params
* Fix documentation for `/_synapse/admin/v2/users/<user_id>`

- Admin is able to
  - change displaynames
  - delete devices
  - list devices
  - get device informations

Fixes #7330

Signed-off-by: Manuel Stahl <manuel.stahl@awesome-technologies.de>

Update documentation to reflect the correct format of user_id (fully qualified).

Signed-off-by: Manuel Stahl <manuel.stahl@awesome-technologies.de>

Signed-off-by: Olivier Wilkinson (reivilibre) <olivier@librepush.net>

Admin API: Set adminship of a user

This endpoint isn't much use for its intended purpose if you first need to get
yourself an admin's auth token.

I've restricted it to the `/_synapse/admin` path to make it a bit easier to
lock down for those concerned about exposing this information. I don't imagine
anyone is using it in anger currently.

Signed-off-by: Joseph Weston <joseph@weston.cloud>

Allow for the creation of a support user.

A support user can access the server, join rooms, interact with other users, but does not appear in the user directory nor does it contribute to monthly active user limits.

People keep asking why their database hasn't gotten smaller after using this API.

Signed-off-by: Aaron Raimist <aaron@raim.ist>

Presumably this is the intention anyways. I've also updated the domain part to be something more along the lines of what people might expect.

clarify that `purge_history` will not purge state