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

docs/api/store/paths/customers_password-reset.yaml

@@ -0,0 +1,37 @@
+post:
+  operationId: PostCustomersResetPassword
+  summary: Resets Customer password
+  description: >-
+    Resets a Customer's password using a password token created by a previous
+    /password-token request.
+  requestBody:
+    content:
+      application/json:
+        schema:
+          required:
+            - email
+            - password
+            - token
+          properties:
+            email:
+              description: The email of the customer.
+              type: string
+              format: email
+            password:
+              description: The Customer's password.
+              type: string
+              format: password
+            token:
+              description: The reset password token
+              type: string
+  tags:
+    - Customer
+  responses:
+    '200':
+      description: OK
+      content:
+        application/json:
+          schema:
+            properties:
+              customer:
+                $ref: ../components/schemas/customer.yaml