summary refs log tree commit diff
path: root/docs/admin_api/room_membership.md
diff options
context:
space:
mode:
authorDirk Klimpel <5740567+dklimpel@users.noreply.github.com>2020-03-27 20:16:43 +0100
committerGitHub <noreply@github.com>2020-03-27 19:16:43 +0000
commitfb69690761762092c8e44d509d4f72408c4c67e0 (patch)
treebcbbd30736e490d1208cc27331e5231b2b8f36d5 /docs/admin_api/room_membership.md
parentAdd options to prevent users from changing their profile. (#7096) (diff)
downloadsynapse-fb69690761762092c8e44d509d4f72408c4c67e0.tar.xz
Admin API to join users to a room. (#7051)
Diffstat (limited to 'docs/admin_api/room_membership.md')
-rw-r--r--docs/admin_api/room_membership.md34
1 files changed, 34 insertions, 0 deletions
diff --git a/docs/admin_api/room_membership.md b/docs/admin_api/room_membership.md
new file mode 100644
index 0000000000..16736d3d37
--- /dev/null
+++ b/docs/admin_api/room_membership.md
@@ -0,0 +1,34 @@
+# Edit Room Membership API
+
+This API allows an administrator to join an user account with a given `user_id`
+to a room with a given `room_id_or_alias`. You can only modify the membership of
+local users. The server administrator must be in the room and have permission to
+invite users.
+
+## Parameters
+
+The following parameters are available:
+
+* `user_id` - Fully qualified user: for example, `@user:server.com`.
+* `room_id_or_alias` - The room identifier or alias to join: for example,
+  `!636q39766251:server.com`.
+
+## Usage
+
+```
+POST /_synapse/admin/v1/join/<room_id_or_alias>
+
+{
+  "user_id": "@user:server.com"
+}
+```
+
+Including an `access_token` of a server admin.
+
+Response:
+
+```
+{
+  "room_id": "!636q39766251:server.com"
+}
+```