From 111e7feabc474a3253e01f576d38a31153de9638 Mon Sep 17 00:00:00 2001 From: clokep Date: Tue, 16 Nov 2021 12:44:21 +0000 Subject: [PATCH] deploy: 24b61f379ac1fc740e1b569b85363e2a0411883a --- develop/admin_api/user_admin_api.html | 9 ++++++--- develop/print.html | 9 ++++++--- develop/searchindex.js | 2 +- develop/searchindex.json | 2 +- 4 files changed, 14 insertions(+), 8 deletions(-) diff --git a/develop/admin_api/user_admin_api.html b/develop/admin_api/user_admin_api.html index dfdad4e433..f9291da868 100644 --- a/develop/admin_api/user_admin_api.html +++ b/develop/admin_api/user_admin_api.html @@ -1000,7 +1000,7 @@ Max length, 512 bytes.

See also the Client-Server API Spec on pushers.

-

Shadow-banning users

+

Controlling whether a user is shadow-banned

Shadow-banning is a useful tool for moderating malicious or egregiously abusive users. A shadow-banned users receives successful responses to their client-server API requests, but the events are not propagated into rooms. This can be an effective tool as it @@ -1010,12 +1010,15 @@ pivoting to another account.

or broken behaviour for the client. A shadow-banned user will not receive any notification and it is generally more appropriate to ban or kick abusive users. A shadow-banned user will be unable to contact anyone on the server.

-

The API is:

+

To shadow-ban a user the API is:

POST /_synapse/admin/v1/users/<user_id>/shadow_ban
 
+

To un-shadow-ban a user the API is:

+
DELETE /_synapse/admin/v1/users/<user_id>/shadow_ban
+

To use it, you will need to authenticate by providing an access_token for a server admin: Admin API

-

An empty JSON dict is returned.

+

An empty JSON dict is returned in both cases.

Parameters

The following parameters should be set in the URL:

See also the Client-Server API Spec on pushers.

-

Shadow-banning users

+

Controlling whether a user is shadow-banned

Shadow-banning is a useful tool for moderating malicious or egregiously abusive users. A shadow-banned users receives successful responses to their client-server API requests, but the events are not propagated into rooms. This can be an effective tool as it @@ -11632,12 +11632,15 @@ pivoting to another account.

or broken behaviour for the client. A shadow-banned user will not receive any notification and it is generally more appropriate to ban or kick abusive users. A shadow-banned user will be unable to contact anyone on the server.

-

The API is:

+

To shadow-ban a user the API is:

POST /_synapse/admin/v1/users/<user_id>/shadow_ban
 
+

To un-shadow-ban a user the API is:

+
DELETE /_synapse/admin/v1/users/<user_id>/shadow_ban
+

To use it, you will need to authenticate by providing an access_token for a server admin: Admin API

-

An empty JSON dict is returned.

+

An empty JSON dict is returned in both cases.

Parameters

The following parameters should be set in the URL: