Create docs for login route.

docs/openapi.yaml

@@ -36,3 +36,6 @@ paths:
   /user:
     post:
       $ref: "./paths/user/create.yaml"
+  /user/login:
+    post:
+      $ref: "./paths/user/login.yaml"

docs/paths/user/login.yaml

@@ -0,0 +1,40 @@
+operationId: userLogin
+summary: Login
+security: []
+description: User login
+tags: [User]
+requestBody:
+  content:
+    application/json:
+      schema:
+        type: object
+        required:
+          - email
+          - password
+        properties:
+          email:
+            type: string
+            format: email
+            description: User email address
+            example: john.smith@mail.com
+          password:
+            type: string
+            description: User password
+            example: password123
+
+responses:
+  "200":
+    description: "User logged in (always returns '{success: true}')"
+    content:
+      application/json:
+        schema:
+          type: object
+          properties:
+            success:
+              type: boolean
+  "400":
+    $ref: "#/components/responses/400"
+  "401":
+    $ref: "#/components/responses/401"
+  "500":
+    $ref: "#/components/responses/500"