summary refs log tree commit diff
path: root/docs/admin_api/account_validity.rst
diff options
context:
space:
mode:
authorRichard van der Hoff <richard@matrix.org>2021-06-04 10:41:36 +0100
committerRichard van der Hoff <richard@matrix.org>2021-06-04 10:41:36 +0100
commitf36457dce23b2a6c39715093dac03677af35c29a (patch)
treea641afcade2ba05606b67507dfbdf70a4dbf0fb1 /docs/admin_api/account_validity.rst
parentMerge remote-tracking branch 'origin/develop' into matrix-org-hotfixes (diff)
parentLimit number of events in a replication request (#10118) (diff)
downloadsynapse-f36457dce23b2a6c39715093dac03677af35c29a.tar.xz
Merge remote-tracking branch 'origin/develop' into matrix-org-hotfixes
Diffstat (limited to 'docs/admin_api/account_validity.rst')
-rw-r--r--docs/admin_api/account_validity.rst42
1 files changed, 0 insertions, 42 deletions
diff --git a/docs/admin_api/account_validity.rst b/docs/admin_api/account_validity.rst
deleted file mode 100644
index 7559de4c57..0000000000
--- a/docs/admin_api/account_validity.rst
+++ /dev/null
@@ -1,42 +0,0 @@
-Account validity API
-====================
-
-This API allows a server administrator to manage the validity of an account. To
-use it, you must enable the account validity feature (under
-``account_validity``) in Synapse's configuration.
-
-Renew account
--------------
-
-This API extends the validity of an account by as much time as configured in the
-``period`` parameter from the ``account_validity`` configuration.
-
-The API is::
-
-    POST /_synapse/admin/v1/account_validity/validity
-
-with the following body:
-
-.. code:: json
-
-    {
-        "user_id": "<user ID for the account to renew>",
-        "expiration_ts": 0,
-        "enable_renewal_emails": true
-    }
-
-
-``expiration_ts`` is an optional parameter and overrides the expiration date,
-which otherwise defaults to now + validity period.
-
-``enable_renewal_emails`` is also an optional parameter and enables/disables
-sending renewal emails to the user. Defaults to true.
-
-The API returns with the new expiration date for this account, as a timestamp in
-milliseconds since epoch:
-
-.. code:: json
-
-    {
-        "expiration_ts": 0
-    }