chore(docs): Refactor API Reference (#1883)

docs/api/admin/paths/users_reset-password.yaml

@@ -0,0 +1,35 @@
+post:
+  operationId: PostUsersUserPassword
+  summary: Set the password for a User.
+  description: Sets the password for a User given the correct token.
+  x-authenticated: true
+  requestBody:
+    content:
+      application/json:
+        schema:
+          required:
+            - token
+            - password
+          properties:
+            email:
+              description: The Users email.
+              type: string
+              format: email
+            token:
+              description: The token generated from the 'password-token' endpoint.
+              type: string
+            password:
+              description: The Users new password.
+              type: string
+              format: password
+  tags:
+    - User
+  responses:
+    '200':
+      description: OK
+      content:
+        application/json:
+          schema:
+            properties:
+              user:
+                $ref: ../components/schemas/user.yaml