From 918eba173f50b8ecc4a608edbd17b2238e37a0fb Mon Sep 17 00:00:00 2001 From: reivilibre Date: Wed, 2 Mar 2022 10:45:52 +0000 Subject: deploy: 879e4a7bd7a90cda4c8ea908aede53d8e038ca7c --- v1.54/admin_api/account_validity.html | 284 ++++++++++++++++++++++++++++++++++ 1 file changed, 284 insertions(+) create mode 100644 v1.54/admin_api/account_validity.html (limited to 'v1.54/admin_api/account_validity.html') diff --git a/v1.54/admin_api/account_validity.html b/v1.54/admin_api/account_validity.html new file mode 100644 index 0000000000..5e11a1dc9e --- /dev/null +++ b/v1.54/admin_api/account_validity.html @@ -0,0 +1,284 @@ + + + + + + Account Validity - Synapse + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ + + + + + + + + + + +
+
+ +
+ +
+ +

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.

+

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

+

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:

+
{
+    "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:

+
{
+    "expiration_ts": 0
+}
+
+ +
+ + +
+
+ + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file -- cgit 1.5.1