From 8d5cabc08b0e9f43a913feb6cdcb9ac9001aaf0b Mon Sep 17 00:00:00 2001
From: silverpill <silverpill@firemail.cc>
Date: Fri, 17 Dec 2021 13:26:29 +0000
Subject: [PATCH] Add documentation for /oauth/token and /api/v1/accounts

---
 docs/openapi.yaml | 74 +++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 74 insertions(+)

diff --git a/docs/openapi.yaml b/docs/openapi.yaml
index cbb37e4..0b0201c 100644
--- a/docs/openapi.yaml
+++ b/docs/openapi.yaml
@@ -5,6 +5,80 @@ info:
   version: 1.0.0
 
 paths:
+  /oauth/token:
+    post:
+      summary: Returns an access token, to be used during API calls that are not public.
+      requestBody:
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                grant_type:
+                  type: string
+                  enum:
+                    - password
+                username:
+                  type: string
+                password:
+                  type: string
+      responses:
+        200:
+          description: Successful operation
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  access_token:
+                    type: string
+                  token_type:
+                    type: string
+                    example: Bearer
+                  scope:
+                    type: string
+                    example: read write follow
+                  created_at:
+                    type: integer
+                    example: 1639747526
+        400:
+          description: Invalid token request
+  /api/v1/accounts:
+    post:
+      summary: Creates a user and profile records.
+      requestBody:
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                username:
+                  description: The desired username for the account.
+                  type: string
+                password:
+                  description: The password to be used for login.
+                  type: string
+                wallet_address:
+                  description: Ethereum wallet address
+                  type: string
+                  example: '0xd8da6bf...'
+                invite_code:
+                  description: Invite code
+                  type: string
+                  example: 9b288bfa7dc75fff53e98aa4d76e77d5
+              required:
+                - username
+                - password
+                - wallet_address
+      responses:
+        201:
+          description: Successful operation
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Account'
+        400:
+          description: Invalid user data
   /api/v1/directory:
     get:
       summary: List accounts visible in the directory.