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

docs/api/admin/paths/invites_accept.yaml

@@ -0,0 +1,38 @@
+post:
+  operationId: PostInvitesInviteAccept
+  summary: Accept an Invite
+  description: Accepts an Invite and creates a corresponding user
+  requestBody:
+    content:
+      application/json:
+        schema:
+          required:
+            - token
+            - user
+          properties:
+            token:
+              description: The invite token provided by the admin.
+              type: string
+            user:
+              description: The User to create.
+              type: object
+              required:
+                - first_name
+                - last_name
+                - password
+              properties:
+                first_name:
+                  type: string
+                  description: the first name of the User
+                last_name:
+                  type: string
+                  description: the last name of the User
+                password:
+                  description: The desired password for the User
+                  type: string
+                  format: password
+  tags:
+    - Invite
+  responses:
+    '200':
+      description: OK