summary refs log tree commit diff
path: root/develop/print.html
diff options
context:
space:
mode:
authorclokep <clokep@users.noreply.github.com>2023-05-17 14:40:07 +0000
committerclokep <clokep@users.noreply.github.com>2023-05-17 14:40:07 +0000
commit787e5c1b4145cc7766ebaff545dc75921d8862bf (patch)
tree70b3c26e6ef8de7c955dcbacd34e9ef8b131acd6 /develop/print.html
parentdeploy: 375b0a8a119bb925ca280f050a25a931662fcbb5 (diff)
downloadsynapse-787e5c1b4145cc7766ebaff545dc75921d8862bf.tar.xz
deploy: 41b9def9f2c02118796e147f63abf23bc2d7dc04
Diffstat (limited to 'develop/print.html')
-rw-r--r--develop/print.html20
1 files changed, 20 insertions, 0 deletions
diff --git a/develop/print.html b/develop/print.html
index d9ba346f06..0f65a4c28d 100644
--- a/develop/print.html
+++ b/develop/print.html
@@ -14303,6 +14303,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>