From 787e5c1b4145cc7766ebaff545dc75921d8862bf Mon Sep 17 00:00:00 2001
From: clokep <clokep@users.noreply.github.com>
Date: Wed, 17 May 2023 14:40:07 +0000
Subject: deploy: 41b9def9f2c02118796e147f63abf23bc2d7dc04

---
 develop/admin_api/user_admin_api.html | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

(limited to 'develop/admin_api/user_admin_api.html')

diff --git a/develop/admin_api/user_admin_api.html b/develop/admin_api/user_admin_api.html
index 55af2cadb6..c7322cb65f 100644
--- a/develop/admin_api/user_admin_api.html
+++ b/develop/admin_api/user_admin_api.html
@@ -878,6 +878,26 @@ devices was last seen. (May be a few minutes out of date, for efficiency reasons
 <p><code>total</code> - Total number of user's devices.</p>
 </li>
 </ul>
+<h3 id="create-a-device"><a class="header" href="#create-a-device">Create a device</a></h3>
+<p>Creates a new device for a specific <code>user_id</code> and <code>device_id</code>. Does nothing if the <code>device_id</code> 
+exists already.</p>
+<p>The API is:</p>
+<pre><code>POST /_synapse/admin/v2/users/&lt;user_id&gt;/devices
+
+{
+  &quot;device_id&quot;: &quot;QBUAZIFURK&quot;
+}
+</code></pre>
+<p>An empty JSON dict is returned.</p>
+<p><strong>Parameters</strong></p>
+<p>The following parameters should be set in the URL:</p>
+<ul>
+<li><code>user_id</code> - fully qualified: for example, <code>@user:server.com</code>.</li>
+</ul>
+<p>The following fields are required in the JSON request body:</p>
+<ul>
+<li><code>device_id</code> - The device ID to create.</li>
+</ul>
 <h3 id="delete-multiple-devices"><a class="header" href="#delete-multiple-devices">Delete multiple devices</a></h3>
 <p>Deletes the given devices for a specific <code>user_id</code>, and invalidates
 any access token associated with them.</p>
-- 
cgit 1.5.1