docs: generate OAS for v2 (#7883)

www/apps/api-reference/specs/store/paths/store_carts.yaml

@@ -3,7 +3,65 @@ post:
   summary: Create Cart
   description: Create a cart.
   x-authenticated: false
-  parameters: []
+  parameters:
+    - name: expand
+      in: query
+      description: Comma-separated relations that should be expanded in the returned data.
+      required: false
+      schema:
+        type: string
+        title: expand
+        description: >-
+          Comma-separated relations that should be expanded in the returned
+          data.
+    - name: fields
+      in: query
+      description: |-
+        Comma-separated fields that should be included in the returned data.
+         * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+         * without prefix it will replace the entire default fields.
+      required: false
+      schema:
+        type: string
+        title: fields
+        description: |-
+          Comma-separated fields that should be included in the returned data.
+           * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+           * without prefix it will replace the entire default fields.
+    - name: offset
+      in: query
+      description: The number of items to skip when retrieving a list.
+      required: false
+      schema:
+        type: number
+        title: offset
+        description: The number of items to skip when retrieving a list.
+    - name: limit
+      in: query
+      description: Limit the number of items returned in the list.
+      required: false
+      schema:
+        type: number
+        title: limit
+        description: Limit the number of items returned in the list.
+    - name: order
+      in: query
+      description: >-
+        The field to sort the data by. By default, the sort order is ascending.
+        To change the order to descending, prefix the field name with `-`.
+      required: false
+      schema:
+        type: string
+        title: order
+        description: >-
+          The field to sort the data by. By default, the sort order is
+          ascending. To change the order to descending, prefix the field name
+          with `-`.
+  requestBody:
+    content:
+      application/json:
+        schema:
+          $ref: ../components/schemas/CreateCartWorkflowInput.yaml
   x-codeSamples:
     - lang: Shell
       label: cURL
@@ -12,6 +70,8 @@ post:
   tags:
     - Carts
   responses:
+    '200':
+      description: OK
     '400':
       $ref: ../components/responses/400_error.yaml
     '401':
@@ -24,7 +84,3 @@ post:
       $ref: ../components/responses/invalid_request_error.yaml
     '500':
       $ref: ../components/responses/500_error.yaml
-  requestBody:
-    content:
-      application/json:
-        schema: {}

www/apps/api-reference/specs/store/paths/store_carts_{id}.yaml

@@ -12,6 +12,59 @@ get:
       required: true
       schema:
         type: string
+    - name: expand
+      in: query
+      description: Comma-separated relations that should be expanded in the returned data.
+      required: false
+      schema:
+        type: string
+        title: expand
+        description: >-
+          Comma-separated relations that should be expanded in the returned
+          data.
+    - name: fields
+      in: query
+      description: |-
+        Comma-separated fields that should be included in the returned data.
+         * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+         * without prefix it will replace the entire default fields.
+      required: false
+      schema:
+        type: string
+        title: fields
+        description: |-
+          Comma-separated fields that should be included in the returned data.
+           * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+           * without prefix it will replace the entire default fields.
+    - name: offset
+      in: query
+      description: The number of items to skip when retrieving a list.
+      required: false
+      schema:
+        type: number
+        title: offset
+        description: The number of items to skip when retrieving a list.
+    - name: limit
+      in: query
+      description: Limit the number of items returned in the list.
+      required: false
+      schema:
+        type: number
+        title: limit
+        description: Limit the number of items returned in the list.
+    - name: order
+      in: query
+      description: >-
+        The field to sort the data by. By default, the sort order is ascending.
+        To change the order to descending, prefix the field name with `-`.
+      required: false
+      schema:
+        type: string
+        title: order
+        description: >-
+          The field to sort the data by. By default, the sort order is
+          ascending. To change the order to descending, prefix the field name
+          with `-`.
   x-codeSamples:
     - lang: Shell
       label: cURL
@@ -20,6 +73,8 @@ get:
   tags:
     - Carts
   responses:
+    '200':
+      description: OK
     '400':
       $ref: ../components/responses/400_error.yaml
     '401':
@@ -32,10 +87,6 @@ get:
       $ref: ../components/responses/invalid_request_error.yaml
     '500':
       $ref: ../components/responses/500_error.yaml
-  requestBody:
-    content:
-      application/json:
-        schema: {}
 post:
   operationId: PostCartsId
   summary: Update a Cart
@@ -48,6 +99,64 @@ post:
       required: true
       schema:
         type: string
+    - name: expand
+      in: query
+      description: Comma-separated relations that should be expanded in the returned data.
+      required: false
+      schema:
+        type: string
+        title: expand
+        description: >-
+          Comma-separated relations that should be expanded in the returned
+          data.
+    - name: fields
+      in: query
+      description: |-
+        Comma-separated fields that should be included in the returned data.
+         * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+         * without prefix it will replace the entire default fields.
+      required: false
+      schema:
+        type: string
+        title: fields
+        description: |-
+          Comma-separated fields that should be included in the returned data.
+           * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+           * without prefix it will replace the entire default fields.
+    - name: offset
+      in: query
+      description: The number of items to skip when retrieving a list.
+      required: false
+      schema:
+        type: number
+        title: offset
+        description: The number of items to skip when retrieving a list.
+    - name: limit
+      in: query
+      description: Limit the number of items returned in the list.
+      required: false
+      schema:
+        type: number
+        title: limit
+        description: Limit the number of items returned in the list.
+    - name: order
+      in: query
+      description: >-
+        The field to sort the data by. By default, the sort order is ascending.
+        To change the order to descending, prefix the field name with `-`.
+      required: false
+      schema:
+        type: string
+        title: order
+        description: >-
+          The field to sort the data by. By default, the sort order is
+          ascending. To change the order to descending, prefix the field name
+          with `-`.
+  requestBody:
+    content:
+      application/json:
+        schema:
+          $ref: ../components/schemas/UpdateCartData.yaml
   x-codeSamples:
     - lang: Shell
       label: cURL
@@ -56,6 +165,8 @@ post:
   tags:
     - Carts
   responses:
+    '200':
+      description: OK
     '400':
       $ref: ../components/responses/400_error.yaml
     '401':
@@ -68,7 +179,3 @@ post:
       $ref: ../components/responses/invalid_request_error.yaml
     '500':
       $ref: ../components/responses/500_error.yaml
-  requestBody:
-    content:
-      application/json:
-        schema: {}

www/apps/api-reference/specs/store/paths/store_carts_{id}_complete.yaml

@@ -0,0 +1,98 @@
+post:
+  operationId: PostCartsIdComplete
+  summary: Add Completes to Cart
+  description: Add a list of completes to a cart.
+  x-authenticated: false
+  parameters:
+    - name: id
+      in: path
+      description: The cart's ID.
+      required: true
+      schema:
+        type: string
+    - name: expand
+      in: query
+      description: Comma-separated relations that should be expanded in the returned data.
+      required: false
+      schema:
+        type: string
+        title: expand
+        description: >-
+          Comma-separated relations that should be expanded in the returned
+          data.
+    - name: fields
+      in: query
+      description: |-
+        Comma-separated fields that should be included in the returned data.
+         * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+         * without prefix it will replace the entire default fields.
+      required: false
+      schema:
+        type: string
+        title: fields
+        description: |-
+          Comma-separated fields that should be included in the returned data.
+           * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+           * without prefix it will replace the entire default fields.
+    - name: offset
+      in: query
+      description: The number of items to skip when retrieving a list.
+      required: false
+      schema:
+        type: number
+        title: offset
+        description: The number of items to skip when retrieving a list.
+    - name: limit
+      in: query
+      description: Limit the number of items returned in the list.
+      required: false
+      schema:
+        type: number
+        title: limit
+        description: Limit the number of items returned in the list.
+    - name: order
+      in: query
+      description: >-
+        The field to sort the data by. By default, the sort order is ascending.
+        To change the order to descending, prefix the field name with `-`.
+      required: false
+      schema:
+        type: string
+        title: order
+        description: >-
+          The field to sort the data by. By default, the sort order is
+          ascending. To change the order to descending, prefix the field name
+          with `-`.
+  requestBody:
+    content:
+      application/json:
+        schema:
+          type: object
+          description: SUMMARY
+          properties:
+            idempotency_key:
+              type: string
+              title: idempotency_key
+              description: The cart's idempotency key.
+  x-codeSamples:
+    - lang: Shell
+      label: cURL
+      source:
+        $ref: ../code_samples/Shell/store_carts_{id}_complete/post.sh
+  tags:
+    - Carts
+  responses:
+    '200':
+      description: OK
+    '400':
+      $ref: ../components/responses/400_error.yaml
+    '401':
+      $ref: ../components/responses/unauthorized.yaml
+    '404':
+      $ref: ../components/responses/not_found_error.yaml
+    '409':
+      $ref: ../components/responses/invalid_state_error.yaml
+    '422':
+      $ref: ../components/responses/invalid_request_error.yaml
+    '500':
+      $ref: ../components/responses/500_error.yaml

www/apps/api-reference/specs/store/paths/store_carts_{id}_line-items.yaml

@@ -10,6 +10,64 @@ post:
       required: true
       schema:
         type: string
+    - name: expand
+      in: query
+      description: Comma-separated relations that should be expanded in the returned data.
+      required: false
+      schema:
+        type: string
+        title: expand
+        description: >-
+          Comma-separated relations that should be expanded in the returned
+          data.
+    - name: fields
+      in: query
+      description: |-
+        Comma-separated fields that should be included in the returned data.
+         * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+         * without prefix it will replace the entire default fields.
+      required: false
+      schema:
+        type: string
+        title: fields
+        description: |-
+          Comma-separated fields that should be included in the returned data.
+           * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+           * without prefix it will replace the entire default fields.
+    - name: offset
+      in: query
+      description: The number of items to skip when retrieving a list.
+      required: false
+      schema:
+        type: number
+        title: offset
+        description: The number of items to skip when retrieving a list.
+    - name: limit
+      in: query
+      description: Limit the number of items returned in the list.
+      required: false
+      schema:
+        type: number
+        title: limit
+        description: Limit the number of items returned in the list.
+    - name: order
+      in: query
+      description: >-
+        The field to sort the data by. By default, the sort order is ascending.
+        To change the order to descending, prefix the field name with `-`.
+      required: false
+      schema:
+        type: string
+        title: order
+        description: >-
+          The field to sort the data by. By default, the sort order is
+          ascending. To change the order to descending, prefix the field name
+          with `-`.
+  requestBody:
+    content:
+      application/json:
+        schema:
+          $ref: ../components/schemas/StoreAddCartLineItem.yaml
   x-codeSamples:
     - lang: Shell
       label: cURL
@@ -18,6 +76,8 @@ post:
   tags:
     - Carts
   responses:
+    '200':
+      description: OK
     '400':
       $ref: ../components/responses/400_error.yaml
     '401':
@@ -30,7 +90,3 @@ post:
       $ref: ../components/responses/invalid_request_error.yaml
     '500':
       $ref: ../components/responses/500_error.yaml
-  requestBody:
-    content:
-      application/json:
-        schema: {}

www/apps/api-reference/specs/store/paths/store_carts_{id}_line-items_{line_id}.yaml

@@ -16,6 +16,64 @@ post:
       required: true
       schema:
         type: string
+    - name: expand
+      in: query
+      description: Comma-separated relations that should be expanded in the returned data.
+      required: false
+      schema:
+        type: string
+        title: expand
+        description: >-
+          Comma-separated relations that should be expanded in the returned
+          data.
+    - name: fields
+      in: query
+      description: |-
+        Comma-separated fields that should be included in the returned data.
+         * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+         * without prefix it will replace the entire default fields.
+      required: false
+      schema:
+        type: string
+        title: fields
+        description: |-
+          Comma-separated fields that should be included in the returned data.
+           * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+           * without prefix it will replace the entire default fields.
+    - name: offset
+      in: query
+      description: The number of items to skip when retrieving a list.
+      required: false
+      schema:
+        type: number
+        title: offset
+        description: The number of items to skip when retrieving a list.
+    - name: limit
+      in: query
+      description: Limit the number of items returned in the list.
+      required: false
+      schema:
+        type: number
+        title: limit
+        description: Limit the number of items returned in the list.
+    - name: order
+      in: query
+      description: >-
+        The field to sort the data by. By default, the sort order is ascending.
+        To change the order to descending, prefix the field name with `-`.
+      required: false
+      schema:
+        type: string
+        title: order
+        description: >-
+          The field to sort the data by. By default, the sort order is
+          ascending. To change the order to descending, prefix the field name
+          with `-`.
+  requestBody:
+    content:
+      application/json:
+        schema:
+          $ref: ../components/schemas/StoreUpdateCartLineItem.yaml
   x-codeSamples:
     - lang: Shell
       label: cURL
@@ -24,6 +82,8 @@ post:
   tags:
     - Carts
   responses:
+    '200':
+      description: OK
     '400':
       $ref: ../components/responses/400_error.yaml
     '401':
@@ -36,10 +96,6 @@ post:
       $ref: ../components/responses/invalid_request_error.yaml
     '500':
       $ref: ../components/responses/500_error.yaml
-  requestBody:
-    content:
-      application/json:
-        schema: {}
 delete:
   operationId: DeleteCartsIdLineItemsLine_id
   summary: Remove Line Items from Cart
@@ -60,6 +116,59 @@ delete:
       required: true
       schema:
         type: string
+    - name: expand
+      in: query
+      description: Comma-separated relations that should be expanded in the returned data.
+      required: false
+      schema:
+        type: string
+        title: expand
+        description: >-
+          Comma-separated relations that should be expanded in the returned
+          data.
+    - name: fields
+      in: query
+      description: |-
+        Comma-separated fields that should be included in the returned data.
+         * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+         * without prefix it will replace the entire default fields.
+      required: false
+      schema:
+        type: string
+        title: fields
+        description: |-
+          Comma-separated fields that should be included in the returned data.
+           * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+           * without prefix it will replace the entire default fields.
+    - name: offset
+      in: query
+      description: The number of items to skip when retrieving a list.
+      required: false
+      schema:
+        type: number
+        title: offset
+        description: The number of items to skip when retrieving a list.
+    - name: limit
+      in: query
+      description: Limit the number of items returned in the list.
+      required: false
+      schema:
+        type: number
+        title: limit
+        description: Limit the number of items returned in the list.
+    - name: order
+      in: query
+      description: >-
+        The field to sort the data by. By default, the sort order is ascending.
+        To change the order to descending, prefix the field name with `-`.
+      required: false
+      schema:
+        type: string
+        title: order
+        description: >-
+          The field to sort the data by. By default, the sort order is
+          ascending. To change the order to descending, prefix the field name
+          with `-`.
   x-codeSamples:
     - lang: Shell
       label: cURL
@@ -68,6 +177,33 @@ delete:
   tags:
     - Carts
   responses:
+    '200':
+      description: OK
+      content:
+        application/json:
+          schema:
+            type: object
+            description: SUMMARY
+            required:
+              - id
+              - object
+              - deleted
+            properties:
+              id:
+                type: string
+                title: id
+                description: The cart's ID.
+              object:
+                type: string
+                title: object
+                description: The cart's object.
+              deleted:
+                type: boolean
+                title: deleted
+                description: The cart's deleted.
+              parent:
+                type: object
+                description: The cart's parent.
     '400':
       $ref: ../components/responses/400_error.yaml
     '401':
@@ -80,7 +216,3 @@ delete:
       $ref: ../components/responses/invalid_request_error.yaml
     '500':
       $ref: ../components/responses/500_error.yaml
-  requestBody:
-    content:
-      application/json:
-        schema: {}

www/apps/api-reference/specs/store/paths/store_carts_{id}_payment-collections.yaml

@@ -1,36 +0,0 @@
-post:
-  operationId: PostCartsIdPaymentCollections
-  summary: Add Payment Collections to Cart
-  description: Add a list of payment collections to a cart.
-  x-authenticated: false
-  parameters:
-    - name: id
-      in: path
-      description: The cart's ID.
-      required: true
-      schema:
-        type: string
-  x-codeSamples:
-    - lang: Shell
-      label: cURL
-      source:
-        $ref: ../code_samples/Shell/store_carts_{id}_payment-collections/post.sh
-  tags:
-    - Carts
-  responses:
-    '400':
-      $ref: ../components/responses/400_error.yaml
-    '401':
-      $ref: ../components/responses/unauthorized.yaml
-    '404':
-      $ref: ../components/responses/not_found_error.yaml
-    '409':
-      $ref: ../components/responses/invalid_state_error.yaml
-    '422':
-      $ref: ../components/responses/invalid_request_error.yaml
-    '500':
-      $ref: ../components/responses/500_error.yaml
-  requestBody:
-    content:
-      application/json:
-        schema: {}

www/apps/api-reference/specs/store/paths/store_carts_{id}_promotions.yaml

@@ -10,6 +10,75 @@ post:
       required: true
       schema:
         type: string
+    - name: expand
+      in: query
+      description: Comma-separated relations that should be expanded in the returned data.
+      required: false
+      schema:
+        type: string
+        title: expand
+        description: >-
+          Comma-separated relations that should be expanded in the returned
+          data.
+    - name: fields
+      in: query
+      description: |-
+        Comma-separated fields that should be included in the returned data.
+         * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+         * without prefix it will replace the entire default fields.
+      required: false
+      schema:
+        type: string
+        title: fields
+        description: |-
+          Comma-separated fields that should be included in the returned data.
+           * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+           * without prefix it will replace the entire default fields.
+    - name: offset
+      in: query
+      description: The number of items to skip when retrieving a list.
+      required: false
+      schema:
+        type: number
+        title: offset
+        description: The number of items to skip when retrieving a list.
+    - name: limit
+      in: query
+      description: Limit the number of items returned in the list.
+      required: false
+      schema:
+        type: number
+        title: limit
+        description: Limit the number of items returned in the list.
+    - name: order
+      in: query
+      description: >-
+        The field to sort the data by. By default, the sort order is ascending.
+        To change the order to descending, prefix the field name with `-`.
+      required: false
+      schema:
+        type: string
+        title: order
+        description: >-
+          The field to sort the data by. By default, the sort order is
+          ascending. To change the order to descending, prefix the field name
+          with `-`.
+  requestBody:
+    content:
+      application/json:
+        schema:
+          type: object
+          description: SUMMARY
+          required:
+            - promo_codes
+          properties:
+            promo_codes:
+              type: array
+              description: The cart's promo codes.
+              items:
+                type: string
+                title: promo_codes
+                description: The promo code's promo codes.
   x-codeSamples:
     - lang: Shell
       label: cURL
@@ -18,6 +87,8 @@ post:
   tags:
     - Carts
   responses:
+    '200':
+      description: OK
     '400':
       $ref: ../components/responses/400_error.yaml
     '401':
@@ -30,10 +101,6 @@ post:
       $ref: ../components/responses/invalid_request_error.yaml
     '500':
       $ref: ../components/responses/500_error.yaml
-  requestBody:
-    content:
-      application/json:
-        schema: {}
 delete:
   operationId: DeleteCartsIdPromotions
   summary: Remove Promotions from Cart
@@ -48,6 +115,59 @@ delete:
       required: true
       schema:
         type: string
+    - name: expand
+      in: query
+      description: Comma-separated relations that should be expanded in the returned data.
+      required: false
+      schema:
+        type: string
+        title: expand
+        description: >-
+          Comma-separated relations that should be expanded in the returned
+          data.
+    - name: fields
+      in: query
+      description: |-
+        Comma-separated fields that should be included in the returned data.
+         * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+         * without prefix it will replace the entire default fields.
+      required: false
+      schema:
+        type: string
+        title: fields
+        description: |-
+          Comma-separated fields that should be included in the returned data.
+           * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+           * without prefix it will replace the entire default fields.
+    - name: offset
+      in: query
+      description: The number of items to skip when retrieving a list.
+      required: false
+      schema:
+        type: number
+        title: offset
+        description: The number of items to skip when retrieving a list.
+    - name: limit
+      in: query
+      description: Limit the number of items returned in the list.
+      required: false
+      schema:
+        type: number
+        title: limit
+        description: Limit the number of items returned in the list.
+    - name: order
+      in: query
+      description: >-
+        The field to sort the data by. By default, the sort order is ascending.
+        To change the order to descending, prefix the field name with `-`.
+      required: false
+      schema:
+        type: string
+        title: order
+        description: >-
+          The field to sort the data by. By default, the sort order is
+          ascending. To change the order to descending, prefix the field name
+          with `-`.
   x-codeSamples:
     - lang: Shell
       label: cURL
@@ -56,6 +176,8 @@ delete:
   tags:
     - Carts
   responses:
+    '200':
+      description: OK
     '400':
       $ref: ../components/responses/400_error.yaml
     '401':
@@ -68,7 +190,3 @@ delete:
       $ref: ../components/responses/invalid_request_error.yaml
     '500':
       $ref: ../components/responses/500_error.yaml
-  requestBody:
-    content:
-      application/json:
-        schema: {}

www/apps/api-reference/specs/store/paths/store_carts_{id}_shipping-methods.yaml

@@ -0,0 +1,103 @@
+post:
+  operationId: PostCartsIdShippingMethods
+  summary: Add Shipping Methods to Cart
+  description: Add a list of shipping methods to a cart.
+  x-authenticated: false
+  parameters:
+    - name: id
+      in: path
+      description: The cart's ID.
+      required: true
+      schema:
+        type: string
+    - name: expand
+      in: query
+      description: Comma-separated relations that should be expanded in the returned data.
+      required: false
+      schema:
+        type: string
+        title: expand
+        description: >-
+          Comma-separated relations that should be expanded in the returned
+          data.
+    - name: fields
+      in: query
+      description: |-
+        Comma-separated fields that should be included in the returned data.
+         * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+         * without prefix it will replace the entire default fields.
+      required: false
+      schema:
+        type: string
+        title: fields
+        description: |-
+          Comma-separated fields that should be included in the returned data.
+           * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+           * without prefix it will replace the entire default fields.
+    - name: offset
+      in: query
+      description: The number of items to skip when retrieving a list.
+      required: false
+      schema:
+        type: number
+        title: offset
+        description: The number of items to skip when retrieving a list.
+    - name: limit
+      in: query
+      description: Limit the number of items returned in the list.
+      required: false
+      schema:
+        type: number
+        title: limit
+        description: Limit the number of items returned in the list.
+    - name: order
+      in: query
+      description: >-
+        The field to sort the data by. By default, the sort order is ascending.
+        To change the order to descending, prefix the field name with `-`.
+      required: false
+      schema:
+        type: string
+        title: order
+        description: >-
+          The field to sort the data by. By default, the sort order is
+          ascending. To change the order to descending, prefix the field name
+          with `-`.
+  requestBody:
+    content:
+      application/json:
+        schema:
+          type: object
+          description: SUMMARY
+          required:
+            - option_id
+          properties:
+            option_id:
+              type: string
+              title: option_id
+              description: The cart's option id.
+            data:
+              type: object
+              description: The cart's data.
+  x-codeSamples:
+    - lang: Shell
+      label: cURL
+      source:
+        $ref: ../code_samples/Shell/store_carts_{id}_shipping-methods/post.sh
+  tags:
+    - Carts
+  responses:
+    '200':
+      description: OK
+    '400':
+      $ref: ../components/responses/400_error.yaml
+    '401':
+      $ref: ../components/responses/unauthorized.yaml
+    '404':
+      $ref: ../components/responses/not_found_error.yaml
+    '409':
+      $ref: ../components/responses/invalid_state_error.yaml
+    '422':
+      $ref: ../components/responses/invalid_request_error.yaml
+    '500':
+      $ref: ../components/responses/500_error.yaml

www/apps/api-reference/specs/store/paths/store_carts_{id}_taxes.yaml

@@ -10,11 +10,64 @@ post:
       required: true
       schema:
         type: string
+    - name: expand
+      in: query
+      description: Comma-separated relations that should be expanded in the returned data.
+      required: false
+      schema:
+        type: string
+        title: expand
+        description: >-
+          Comma-separated relations that should be expanded in the returned
+          data.
+    - name: fields
+      in: query
+      description: |-
+        Comma-separated fields that should be included in the returned data.
+         * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+         * without prefix it will replace the entire default fields.
+      required: false
+      schema:
+        type: string
+        title: fields
+        description: |-
+          Comma-separated fields that should be included in the returned data.
+           * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+           * without prefix it will replace the entire default fields.
+    - name: offset
+      in: query
+      description: The number of items to skip when retrieving a list.
+      required: false
+      schema:
+        type: number
+        title: offset
+        description: The number of items to skip when retrieving a list.
+    - name: limit
+      in: query
+      description: Limit the number of items returned in the list.
+      required: false
+      schema:
+        type: number
+        title: limit
+        description: Limit the number of items returned in the list.
+    - name: order
+      in: query
+      description: >-
+        The field to sort the data by. By default, the sort order is ascending.
+        To change the order to descending, prefix the field name with `-`.
+      required: false
+      schema:
+        type: string
+        title: order
+        description: >-
+          The field to sort the data by. By default, the sort order is
+          ascending. To change the order to descending, prefix the field name
+          with `-`.
   requestBody:
     content:
       application/json:
         schema:
-          $ref: ../components/schemas/StorePostCartsCartTaxesReq.yaml
+          $ref: ../components/schemas/StoreCalculateCartTaxes.yaml
   x-codeSamples:
     - lang: Shell
       label: cURL
@@ -23,6 +76,8 @@ post:
   tags:
     - Carts
   responses:
+    '200':
+      description: OK
     '400':
       $ref: ../components/responses/400_error.yaml
     '401':

www/apps/api-reference/specs/store/paths/store_collections.yaml

@@ -0,0 +1,83 @@
+get:
+  operationId: GetCollections
+  summary: List Collections
+  description: >-
+    Retrieve a list of collections. The collections can be filtered by fields
+    such as `id`. The collections can also be sorted or paginated.
+  x-authenticated: false
+  parameters:
+    - name: expand
+      in: query
+      description: Comma-separated relations that should be expanded in the returned data.
+      required: false
+      schema:
+        type: string
+        title: expand
+        description: >-
+          Comma-separated relations that should be expanded in the returned
+          data.
+    - name: fields
+      in: query
+      description: |-
+        Comma-separated fields that should be included in the returned data.
+         * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+         * without prefix it will replace the entire default fields.
+      required: false
+      schema:
+        type: string
+        title: fields
+        description: |-
+          Comma-separated fields that should be included in the returned data.
+           * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+           * without prefix it will replace the entire default fields.
+    - name: offset
+      in: query
+      description: The number of items to skip when retrieving a list.
+      required: false
+      schema:
+        type: number
+        title: offset
+        description: The number of items to skip when retrieving a list.
+    - name: limit
+      in: query
+      description: Limit the number of items returned in the list.
+      required: false
+      schema:
+        type: number
+        title: limit
+        description: Limit the number of items returned in the list.
+    - name: order
+      in: query
+      description: >-
+        The field to sort the data by. By default, the sort order is ascending.
+        To change the order to descending, prefix the field name with `-`.
+      required: false
+      schema:
+        type: string
+        title: order
+        description: >-
+          The field to sort the data by. By default, the sort order is
+          ascending. To change the order to descending, prefix the field name
+          with `-`.
+  x-codeSamples:
+    - lang: Shell
+      label: cURL
+      source:
+        $ref: ../code_samples/Shell/store_collections/get.sh
+  tags:
+    - Collections
+  responses:
+    '200':
+      description: OK
+    '400':
+      $ref: ../components/responses/400_error.yaml
+    '401':
+      $ref: ../components/responses/unauthorized.yaml
+    '404':
+      $ref: ../components/responses/not_found_error.yaml
+    '409':
+      $ref: ../components/responses/invalid_state_error.yaml
+    '422':
+      $ref: ../components/responses/invalid_request_error.yaml
+    '500':
+      $ref: ../components/responses/500_error.yaml

www/apps/api-reference/specs/store/paths/store_collections_{id}.yaml

@@ -0,0 +1,89 @@
+get:
+  operationId: GetCollectionsId
+  summary: Get a Collection
+  description: >-
+    Retrieve a collection by its ID. You can expand the collection's relations
+    or select the fields that should be returned.
+  x-authenticated: false
+  parameters:
+    - name: id
+      in: path
+      description: The collection's ID.
+      required: true
+      schema:
+        type: string
+    - name: expand
+      in: query
+      description: Comma-separated relations that should be expanded in the returned data.
+      required: false
+      schema:
+        type: string
+        title: expand
+        description: >-
+          Comma-separated relations that should be expanded in the returned
+          data.
+    - name: fields
+      in: query
+      description: |-
+        Comma-separated fields that should be included in the returned data.
+         * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+         * without prefix it will replace the entire default fields.
+      required: false
+      schema:
+        type: string
+        title: fields
+        description: |-
+          Comma-separated fields that should be included in the returned data.
+           * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+           * without prefix it will replace the entire default fields.
+    - name: offset
+      in: query
+      description: The number of items to skip when retrieving a list.
+      required: false
+      schema:
+        type: number
+        title: offset
+        description: The number of items to skip when retrieving a list.
+    - name: limit
+      in: query
+      description: Limit the number of items returned in the list.
+      required: false
+      schema:
+        type: number
+        title: limit
+        description: Limit the number of items returned in the list.
+    - name: order
+      in: query
+      description: >-
+        The field to sort the data by. By default, the sort order is ascending.
+        To change the order to descending, prefix the field name with `-`.
+      required: false
+      schema:
+        type: string
+        title: order
+        description: >-
+          The field to sort the data by. By default, the sort order is
+          ascending. To change the order to descending, prefix the field name
+          with `-`.
+  x-codeSamples:
+    - lang: Shell
+      label: cURL
+      source:
+        $ref: ../code_samples/Shell/store_collections_{id}/get.sh
+  tags:
+    - Collections
+  responses:
+    '200':
+      description: OK
+    '400':
+      $ref: ../components/responses/400_error.yaml
+    '401':
+      $ref: ../components/responses/unauthorized.yaml
+    '404':
+      $ref: ../components/responses/not_found_error.yaml
+    '409':
+      $ref: ../components/responses/invalid_state_error.yaml
+    '422':
+      $ref: ../components/responses/invalid_request_error.yaml
+    '500':
+      $ref: ../components/responses/500_error.yaml

www/apps/api-reference/specs/store/paths/store_currencies.yaml

@@ -5,7 +5,60 @@ get:
     Retrieve a list of currencies. The currencies can be filtered by fields such
     as `id`. The currencies can also be sorted or paginated.
   x-authenticated: false
-  parameters: []
+  parameters:
+    - name: expand
+      in: query
+      description: Comma-separated relations that should be expanded in the returned data.
+      required: false
+      schema:
+        type: string
+        title: expand
+        description: >-
+          Comma-separated relations that should be expanded in the returned
+          data.
+    - name: fields
+      in: query
+      description: |-
+        Comma-separated fields that should be included in the returned data.
+         * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+         * without prefix it will replace the entire default fields.
+      required: false
+      schema:
+        type: string
+        title: fields
+        description: |-
+          Comma-separated fields that should be included in the returned data.
+           * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+           * without prefix it will replace the entire default fields.
+    - name: offset
+      in: query
+      description: The number of items to skip when retrieving a list.
+      required: false
+      schema:
+        type: number
+        title: offset
+        description: The number of items to skip when retrieving a list.
+    - name: limit
+      in: query
+      description: Limit the number of items returned in the list.
+      required: false
+      schema:
+        type: number
+        title: limit
+        description: Limit the number of items returned in the list.
+    - name: order
+      in: query
+      description: >-
+        The field to sort the data by. By default, the sort order is ascending.
+        To change the order to descending, prefix the field name with `-`.
+      required: false
+      schema:
+        type: string
+        title: order
+        description: >-
+          The field to sort the data by. By default, the sort order is
+          ascending. To change the order to descending, prefix the field name
+          with `-`.
   x-codeSamples:
     - lang: Shell
       label: cURL
@@ -14,6 +67,8 @@ get:
   tags:
     - Currencies
   responses:
+    '200':
+      description: OK
     '400':
       $ref: ../components/responses/400_error.yaml
     '401':
@@ -26,7 +81,3 @@ get:
       $ref: ../components/responses/invalid_request_error.yaml
     '500':
       $ref: ../components/responses/500_error.yaml
-  requestBody:
-    content:
-      application/json:
-        schema: {}

www/apps/api-reference/specs/store/paths/store_currencies_{code}.yaml

@@ -12,6 +12,59 @@ get:
       required: true
       schema:
         type: string
+    - name: expand
+      in: query
+      description: Comma-separated relations that should be expanded in the returned data.
+      required: false
+      schema:
+        type: string
+        title: expand
+        description: >-
+          Comma-separated relations that should be expanded in the returned
+          data.
+    - name: fields
+      in: query
+      description: |-
+        Comma-separated fields that should be included in the returned data.
+         * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+         * without prefix it will replace the entire default fields.
+      required: false
+      schema:
+        type: string
+        title: fields
+        description: |-
+          Comma-separated fields that should be included in the returned data.
+           * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+           * without prefix it will replace the entire default fields.
+    - name: offset
+      in: query
+      description: The number of items to skip when retrieving a list.
+      required: false
+      schema:
+        type: number
+        title: offset
+        description: The number of items to skip when retrieving a list.
+    - name: limit
+      in: query
+      description: Limit the number of items returned in the list.
+      required: false
+      schema:
+        type: number
+        title: limit
+        description: Limit the number of items returned in the list.
+    - name: order
+      in: query
+      description: >-
+        The field to sort the data by. By default, the sort order is ascending.
+        To change the order to descending, prefix the field name with `-`.
+      required: false
+      schema:
+        type: string
+        title: order
+        description: >-
+          The field to sort the data by. By default, the sort order is
+          ascending. To change the order to descending, prefix the field name
+          with `-`.
   x-codeSamples:
     - lang: Shell
       label: cURL
@@ -20,6 +73,8 @@ get:
   tags:
     - Currencies
   responses:
+    '200':
+      description: OK
     '400':
       $ref: ../components/responses/400_error.yaml
     '401':
@@ -32,7 +87,3 @@ get:
       $ref: ../components/responses/invalid_request_error.yaml
     '500':
       $ref: ../components/responses/500_error.yaml
-  requestBody:
-    content:
-      application/json:
-        schema: {}

www/apps/api-reference/specs/store/paths/store_customers.yaml

@@ -3,7 +3,65 @@ post:
   summary: Create Customer
   description: Create a customer.
   x-authenticated: false
-  parameters: []
+  parameters:
+    - name: expand
+      in: query
+      description: Comma-separated relations that should be expanded in the returned data.
+      required: false
+      schema:
+        type: string
+        title: expand
+        description: >-
+          Comma-separated relations that should be expanded in the returned
+          data.
+    - name: fields
+      in: query
+      description: |-
+        Comma-separated fields that should be included in the returned data.
+         * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+         * without prefix it will replace the entire default fields.
+      required: false
+      schema:
+        type: string
+        title: fields
+        description: |-
+          Comma-separated fields that should be included in the returned data.
+           * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+           * without prefix it will replace the entire default fields.
+    - name: offset
+      in: query
+      description: The number of items to skip when retrieving a list.
+      required: false
+      schema:
+        type: number
+        title: offset
+        description: The number of items to skip when retrieving a list.
+    - name: limit
+      in: query
+      description: Limit the number of items returned in the list.
+      required: false
+      schema:
+        type: number
+        title: limit
+        description: Limit the number of items returned in the list.
+    - name: order
+      in: query
+      description: >-
+        The field to sort the data by. By default, the sort order is ascending.
+        To change the order to descending, prefix the field name with `-`.
+      required: false
+      schema:
+        type: string
+        title: order
+        description: >-
+          The field to sort the data by. By default, the sort order is
+          ascending. To change the order to descending, prefix the field name
+          with `-`.
+  requestBody:
+    content:
+      application/json:
+        schema:
+          $ref: ../components/schemas/StoreCreateCustomer.yaml
   x-codeSamples:
     - lang: Shell
       label: cURL
@@ -12,6 +70,8 @@ post:
   tags:
     - Customers
   responses:
+    '200':
+      description: OK
     '400':
       $ref: ../components/responses/400_error.yaml
     '401':
@@ -24,7 +84,3 @@ post:
       $ref: ../components/responses/invalid_request_error.yaml
     '500':
       $ref: ../components/responses/500_error.yaml
-  requestBody:
-    content:
-      application/json:
-        schema: {}

www/apps/api-reference/specs/store/paths/store_customers_me.yaml

@@ -4,8 +4,64 @@ get:
   description: >-
     Retrieve a list of customers. The customers can be filtered by fields such
     as `id`. The customers can also be sorted or paginated.
-  x-authenticated: false
-  parameters: []
+  x-authenticated: true
+  parameters:
+    - name: expand
+      in: query
+      description: Comma-separated relations that should be expanded in the returned data.
+      required: false
+      schema:
+        type: string
+        title: expand
+        description: >-
+          Comma-separated relations that should be expanded in the returned
+          data.
+    - name: fields
+      in: query
+      description: |-
+        Comma-separated fields that should be included in the returned data.
+         * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+         * without prefix it will replace the entire default fields.
+      required: false
+      schema:
+        type: string
+        title: fields
+        description: |-
+          Comma-separated fields that should be included in the returned data.
+           * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+           * without prefix it will replace the entire default fields.
+    - name: offset
+      in: query
+      description: The number of items to skip when retrieving a list.
+      required: false
+      schema:
+        type: number
+        title: offset
+        description: The number of items to skip when retrieving a list.
+    - name: limit
+      in: query
+      description: Limit the number of items returned in the list.
+      required: false
+      schema:
+        type: number
+        title: limit
+        description: Limit the number of items returned in the list.
+    - name: order
+      in: query
+      description: >-
+        The field to sort the data by. By default, the sort order is ascending.
+        To change the order to descending, prefix the field name with `-`.
+      required: false
+      schema:
+        type: string
+        title: order
+        description: >-
+          The field to sort the data by. By default, the sort order is
+          ascending. To change the order to descending, prefix the field name
+          with `-`.
+  security:
+    - cookie_auth: []
+    - jwt_token: []
   x-codeSamples:
     - lang: Shell
       label: cURL
@@ -14,6 +70,8 @@ get:
   tags:
     - Customers
   responses:
+    '200':
+      description: OK
     '400':
       $ref: ../components/responses/400_error.yaml
     '401':
@@ -26,7 +84,92 @@ get:
       $ref: ../components/responses/invalid_request_error.yaml
     '500':
       $ref: ../components/responses/500_error.yaml
+post:
+  operationId: PostCustomersMe
+  summary: Create Customer
+  description: Create a customer.
+  x-authenticated: true
+  parameters:
+    - name: expand
+      in: query
+      description: Comma-separated relations that should be expanded in the returned data.
+      required: false
+      schema:
+        type: string
+        title: expand
+        description: >-
+          Comma-separated relations that should be expanded in the returned
+          data.
+    - name: fields
+      in: query
+      description: |-
+        Comma-separated fields that should be included in the returned data.
+         * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+         * without prefix it will replace the entire default fields.
+      required: false
+      schema:
+        type: string
+        title: fields
+        description: |-
+          Comma-separated fields that should be included in the returned data.
+           * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+           * without prefix it will replace the entire default fields.
+    - name: offset
+      in: query
+      description: The number of items to skip when retrieving a list.
+      required: false
+      schema:
+        type: number
+        title: offset
+        description: The number of items to skip when retrieving a list.
+    - name: limit
+      in: query
+      description: Limit the number of items returned in the list.
+      required: false
+      schema:
+        type: number
+        title: limit
+        description: Limit the number of items returned in the list.
+    - name: order
+      in: query
+      description: >-
+        The field to sort the data by. By default, the sort order is ascending.
+        To change the order to descending, prefix the field name with `-`.
+      required: false
+      schema:
+        type: string
+        title: order
+        description: >-
+          The field to sort the data by. By default, the sort order is
+          ascending. To change the order to descending, prefix the field name
+          with `-`.
+  security:
+    - cookie_auth: []
+    - jwt_token: []
   requestBody:
     content:
       application/json:
-        schema: {}
+        schema:
+          $ref: ../components/schemas/StoreUpdateCustomer.yaml
+  x-codeSamples:
+    - lang: Shell
+      label: cURL
+      source:
+        $ref: ../code_samples/Shell/store_customers_me/post.sh
+  tags:
+    - Customers
+  responses:
+    '200':
+      description: OK
+    '400':
+      $ref: ../components/responses/400_error.yaml
+    '401':
+      $ref: ../components/responses/unauthorized.yaml
+    '404':
+      $ref: ../components/responses/not_found_error.yaml
+    '409':
+      $ref: ../components/responses/invalid_state_error.yaml
+    '422':
+      $ref: ../components/responses/invalid_request_error.yaml
+    '500':
+      $ref: ../components/responses/500_error.yaml

www/apps/api-reference/specs/store/paths/store_customers_me_addresses.yaml

@@ -4,8 +4,175 @@ get:
   description: >-
     Retrieve a list of customers. The customers can be filtered by fields such
     as `id`. The customers can also be sorted or paginated.
-  x-authenticated: false
-  parameters: []
+  x-authenticated: true
+  parameters:
+    - name: expand
+      in: query
+      description: Comma-separated relations that should be expanded in the returned data.
+      required: false
+      schema:
+        type: string
+        title: expand
+        description: >-
+          Comma-separated relations that should be expanded in the returned
+          data.
+    - name: fields
+      in: query
+      description: |-
+        Comma-separated fields that should be included in the returned data.
+         * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+         * without prefix it will replace the entire default fields.
+      required: false
+      schema:
+        type: string
+        title: fields
+        description: |-
+          Comma-separated fields that should be included in the returned data.
+           * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+           * without prefix it will replace the entire default fields.
+    - name: offset
+      in: query
+      description: The number of items to skip when retrieving a list.
+      required: false
+      schema:
+        type: number
+        title: offset
+        description: The number of items to skip when retrieving a list.
+    - name: limit
+      in: query
+      description: Limit the number of items returned in the list.
+      required: false
+      schema:
+        type: number
+        title: limit
+        description: Limit the number of items returned in the list.
+    - name: order
+      in: query
+      description: >-
+        The field to sort the data by. By default, the sort order is ascending.
+        To change the order to descending, prefix the field name with `-`.
+      required: false
+      schema:
+        type: string
+        title: order
+        description: >-
+          The field to sort the data by. By default, the sort order is
+          ascending. To change the order to descending, prefix the field name
+          with `-`.
+    - name: metadata
+      in: query
+      description: The customer's metadata.
+      required: true
+      schema:
+        type: object
+        description: The customer's metadata.
+    - name: first_name
+      in: query
+      description: The customer's first name.
+      required: true
+      schema:
+        type: string
+        title: first_name
+        description: The customer's first name.
+    - name: last_name
+      in: query
+      description: The customer's last name.
+      required: true
+      schema:
+        type: string
+        title: last_name
+        description: The customer's last name.
+    - name: phone
+      in: query
+      description: The customer's phone.
+      required: true
+      schema:
+        type: string
+        title: phone
+        description: The customer's phone.
+    - name: company
+      in: query
+      description: The customer's company.
+      required: true
+      schema:
+        type: string
+        title: company
+        description: The customer's company.
+    - name: address_1
+      in: query
+      description: The customer's address 1.
+      required: true
+      schema:
+        type: string
+        title: address_1
+        description: The customer's address 1.
+    - name: address_2
+      in: query
+      description: The customer's address 2.
+      required: true
+      schema:
+        type: string
+        title: address_2
+        description: The customer's address 2.
+    - name: city
+      in: query
+      description: The customer's city.
+      required: true
+      schema:
+        type: string
+        title: city
+        description: The customer's city.
+    - name: country_code
+      in: query
+      description: The customer's country code.
+      required: true
+      schema:
+        type: string
+        title: country_code
+        description: The customer's country code.
+    - name: province
+      in: query
+      description: The customer's province.
+      required: true
+      schema:
+        type: string
+        title: province
+        description: The customer's province.
+    - name: postal_code
+      in: query
+      description: The customer's postal code.
+      required: true
+      schema:
+        type: string
+        title: postal_code
+        description: The customer's postal code.
+    - name: address_name
+      in: query
+      description: The customer's address name.
+      required: true
+      schema:
+        type: string
+        title: address_name
+        description: The customer's address name.
+    - name: is_default_shipping
+      in: query
+      description: The customer's is default shipping.
+      required: false
+      schema:
+        type: boolean
+        title: is_default_shipping
+        description: The customer's is default shipping.
+    - name: is_default_billing
+      in: query
+      description: The customer's is default billing.
+      required: false
+      schema:
+        type: boolean
+        title: is_default_billing
+        description: The customer's is default billing.
+  security:
+    - cookie_auth: []
+    - jwt_token: []
   x-codeSamples:
     - lang: Shell
       label: cURL
@@ -14,6 +181,8 @@ get:
   tags:
     - Customers
   responses:
+    '200':
+      description: OK
     '400':
       $ref: ../components/responses/400_error.yaml
     '401':
@@ -26,16 +195,143 @@ get:
       $ref: ../components/responses/invalid_request_error.yaml
     '500':
       $ref: ../components/responses/500_error.yaml
-  requestBody:
-    content:
-      application/json:
-        schema: {}
 post:
   operationId: PostCustomersMeAddresses
   summary: Create Customer
   description: Create a customer.
-  x-authenticated: false
-  parameters: []
+  x-authenticated: true
+  parameters:
+    - name: expand
+      in: query
+      description: Comma-separated relations that should be expanded in the returned data.
+      required: false
+      schema:
+        type: string
+        title: expand
+        description: >-
+          Comma-separated relations that should be expanded in the returned
+          data.
+    - name: fields
+      in: query
+      description: |-
+        Comma-separated fields that should be included in the returned data.
+         * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+         * without prefix it will replace the entire default fields.
+      required: false
+      schema:
+        type: string
+        title: fields
+        description: |-
+          Comma-separated fields that should be included in the returned data.
+           * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+           * without prefix it will replace the entire default fields.
+    - name: offset
+      in: query
+      description: The number of items to skip when retrieving a list.
+      required: false
+      schema:
+        type: number
+        title: offset
+        description: The number of items to skip when retrieving a list.
+    - name: limit
+      in: query
+      description: Limit the number of items returned in the list.
+      required: false
+      schema:
+        type: number
+        title: limit
+        description: Limit the number of items returned in the list.
+    - name: order
+      in: query
+      description: >-
+        The field to sort the data by. By default, the sort order is ascending.
+        To change the order to descending, prefix the field name with `-`.
+      required: false
+      schema:
+        type: string
+        title: order
+        description: >-
+          The field to sort the data by. By default, the sort order is
+          ascending. To change the order to descending, prefix the field name
+          with `-`.
+  security:
+    - cookie_auth: []
+    - jwt_token: []
+  requestBody:
+    content:
+      application/json:
+        schema:
+          type: object
+          description: SUMMARY
+          required:
+            - metadata
+            - first_name
+            - last_name
+            - phone
+            - company
+            - address_1
+            - address_2
+            - city
+            - country_code
+            - province
+            - postal_code
+            - address_name
+          properties:
+            metadata:
+              type: object
+              description: The customer's metadata.
+            first_name:
+              type: string
+              title: first_name
+              description: The customer's first name.
+            last_name:
+              type: string
+              title: last_name
+              description: The customer's last name.
+            phone:
+              type: string
+              title: phone
+              description: The customer's phone.
+            company:
+              type: string
+              title: company
+              description: The customer's company.
+            address_1:
+              type: string
+              title: address_1
+              description: The customer's address 1.
+            address_2:
+              type: string
+              title: address_2
+              description: The customer's address 2.
+            city:
+              type: string
+              title: city
+              description: The customer's city.
+            country_code:
+              type: string
+              title: country_code
+              description: The customer's country code.
+            province:
+              type: string
+              title: province
+              description: The customer's province.
+            postal_code:
+              type: string
+              title: postal_code
+              description: The customer's postal code.
+            address_name:
+              type: string
+              title: address_name
+              description: The customer's address name.
+            is_default_shipping:
+              type: boolean
+              title: is_default_shipping
+              description: The customer's is default shipping.
+            is_default_billing:
+              type: boolean
+              title: is_default_billing
+              description: The customer's is default billing.
   x-codeSamples:
     - lang: Shell
       label: cURL
@@ -44,6 +340,8 @@ post:
   tags:
     - Customers
   responses:
+    '200':
+      description: OK
     '400':
       $ref: ../components/responses/400_error.yaml
     '401':
@@ -56,7 +354,3 @@ post:
       $ref: ../components/responses/invalid_request_error.yaml
     '500':
       $ref: ../components/responses/500_error.yaml
-  requestBody:
-    content:
-      application/json:
-        schema: {}

www/apps/api-reference/specs/store/paths/store_customers_me_addresses_{address_id}.yaml

@@ -4,7 +4,7 @@ get:
   description: >-
     Retrieve a list of addresses in a customer. The addresses can be filtered by
     fields like FILTER FIELDS. The addresses can also be paginated.
-  x-authenticated: false
+  x-authenticated: true
   parameters:
     - name: address_id
       in: path
@@ -12,6 +12,62 @@ get:
       required: true
       schema:
         type: string
+    - name: expand
+      in: query
+      description: Comma-separated relations that should be expanded in the returned data.
+      required: false
+      schema:
+        type: string
+        title: expand
+        description: >-
+          Comma-separated relations that should be expanded in the returned
+          data.
+    - name: fields
+      in: query
+      description: |-
+        Comma-separated fields that should be included in the returned data.
+         * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+         * without prefix it will replace the entire default fields.
+      required: false
+      schema:
+        type: string
+        title: fields
+        description: |-
+          Comma-separated fields that should be included in the returned data.
+           * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+           * without prefix it will replace the entire default fields.
+    - name: offset
+      in: query
+      description: The number of items to skip when retrieving a list.
+      required: false
+      schema:
+        type: number
+        title: offset
+        description: The number of items to skip when retrieving a list.
+    - name: limit
+      in: query
+      description: Limit the number of items returned in the list.
+      required: false
+      schema:
+        type: number
+        title: limit
+        description: Limit the number of items returned in the list.
+    - name: order
+      in: query
+      description: >-
+        The field to sort the data by. By default, the sort order is ascending.
+        To change the order to descending, prefix the field name with `-`.
+      required: false
+      schema:
+        type: string
+        title: order
+        description: >-
+          The field to sort the data by. By default, the sort order is
+          ascending. To change the order to descending, prefix the field name
+          with `-`.
+  security:
+    - cookie_auth: []
+    - jwt_token: []
   x-codeSamples:
     - lang: Shell
       label: cURL
@@ -20,6 +76,8 @@ get:
   tags:
     - Customers
   responses:
+    '200':
+      description: OK
     '400':
       $ref: ../components/responses/400_error.yaml
     '401':
@@ -32,15 +90,11 @@ get:
       $ref: ../components/responses/invalid_request_error.yaml
     '500':
       $ref: ../components/responses/500_error.yaml
-  requestBody:
-    content:
-      application/json:
-        schema: {}
 post:
   operationId: PostCustomersMeAddressesAddress_id
   summary: Add Addresses to Customer
   description: Add a list of addresses to a customer.
-  x-authenticated: false
+  x-authenticated: true
   parameters:
     - name: address_id
       in: path
@@ -48,6 +102,137 @@ post:
       required: true
       schema:
         type: string
+    - name: expand
+      in: query
+      description: Comma-separated relations that should be expanded in the returned data.
+      required: false
+      schema:
+        type: string
+        title: expand
+        description: >-
+          Comma-separated relations that should be expanded in the returned
+          data.
+    - name: fields
+      in: query
+      description: |-
+        Comma-separated fields that should be included in the returned data.
+         * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+         * without prefix it will replace the entire default fields.
+      required: false
+      schema:
+        type: string
+        title: fields
+        description: |-
+          Comma-separated fields that should be included in the returned data.
+           * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+           * without prefix it will replace the entire default fields.
+    - name: offset
+      in: query
+      description: The number of items to skip when retrieving a list.
+      required: false
+      schema:
+        type: number
+        title: offset
+        description: The number of items to skip when retrieving a list.
+    - name: limit
+      in: query
+      description: Limit the number of items returned in the list.
+      required: false
+      schema:
+        type: number
+        title: limit
+        description: Limit the number of items returned in the list.
+    - name: order
+      in: query
+      description: >-
+        The field to sort the data by. By default, the sort order is ascending.
+        To change the order to descending, prefix the field name with `-`.
+      required: false
+      schema:
+        type: string
+        title: order
+        description: >-
+          The field to sort the data by. By default, the sort order is
+          ascending. To change the order to descending, prefix the field name
+          with `-`.
+  security:
+    - cookie_auth: []
+    - jwt_token: []
+  requestBody:
+    content:
+      application/json:
+        schema:
+          type: object
+          description: SUMMARY
+          required:
+            - metadata
+            - first_name
+            - last_name
+            - phone
+            - company
+            - address_1
+            - address_2
+            - city
+            - country_code
+            - province
+            - postal_code
+            - address_name
+          properties:
+            metadata:
+              type: object
+              description: The customer's metadata.
+            first_name:
+              type: string
+              title: first_name
+              description: The customer's first name.
+            last_name:
+              type: string
+              title: last_name
+              description: The customer's last name.
+            phone:
+              type: string
+              title: phone
+              description: The customer's phone.
+            company:
+              type: string
+              title: company
+              description: The customer's company.
+            address_1:
+              type: string
+              title: address_1
+              description: The customer's address 1.
+            address_2:
+              type: string
+              title: address_2
+              description: The customer's address 2.
+            city:
+              type: string
+              title: city
+              description: The customer's city.
+            country_code:
+              type: string
+              title: country_code
+              description: The customer's country code.
+            province:
+              type: string
+              title: province
+              description: The customer's province.
+            postal_code:
+              type: string
+              title: postal_code
+              description: The customer's postal code.
+            address_name:
+              type: string
+              title: address_name
+              description: The customer's address name.
+            is_default_shipping:
+              type: boolean
+              title: is_default_shipping
+              description: The customer's is default shipping.
+            is_default_billing:
+              type: boolean
+              title: is_default_billing
+              description: The customer's is default billing.
   x-codeSamples:
     - lang: Shell
       label: cURL
@@ -57,6 +242,8 @@ post:
   tags:
     - Customers
   responses:
+    '200':
+      description: OK
     '400':
       $ref: ../components/responses/400_error.yaml
     '401':
@@ -69,17 +256,13 @@ post:
       $ref: ../components/responses/invalid_request_error.yaml
     '500':
       $ref: ../components/responses/500_error.yaml
-  requestBody:
-    content:
-      application/json:
-        schema: {}
 delete:
   operationId: DeleteCustomersMeAddressesAddress_id
   summary: Remove Addresses from Customer
   description: >-
     Remove a list of addresses from a customer. This doesn't delete the Address,
     only the association between the Address and the customer.
-  x-authenticated: false
+  x-authenticated: true
   parameters:
     - name: address_id
       in: path
@@ -87,6 +270,62 @@ delete:
       required: true
       schema:
         type: string
+    - name: expand
+      in: query
+      description: Comma-separated relations that should be expanded in the returned data.
+      required: false
+      schema:
+        type: string
+        title: expand
+        description: >-
+          Comma-separated relations that should be expanded in the returned
+          data.
+    - name: fields
+      in: query
+      description: |-
+        Comma-separated fields that should be included in the returned data.
+         * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+         * without prefix it will replace the entire default fields.
+      required: false
+      schema:
+        type: string
+        title: fields
+        description: |-
+          Comma-separated fields that should be included in the returned data.
+           * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+           * without prefix it will replace the entire default fields.
+    - name: offset
+      in: query
+      description: The number of items to skip when retrieving a list.
+      required: false
+      schema:
+        type: number
+        title: offset
+        description: The number of items to skip when retrieving a list.
+    - name: limit
+      in: query
+      description: Limit the number of items returned in the list.
+      required: false
+      schema:
+        type: number
+        title: limit
+        description: Limit the number of items returned in the list.
+    - name: order
+      in: query
+      description: >-
+        The field to sort the data by. By default, the sort order is ascending.
+        To change the order to descending, prefix the field name with `-`.
+      required: false
+      schema:
+        type: string
+        title: order
+        description: >-
+          The field to sort the data by. By default, the sort order is
+          ascending. To change the order to descending, prefix the field name
+          with `-`.
+  security:
+    - cookie_auth: []
+    - jwt_token: []
   x-codeSamples:
     - lang: Shell
       label: cURL
@@ -96,6 +335,8 @@ delete:
   tags:
     - Customers
   responses:
+    '200':
+      description: OK
     '400':
       $ref: ../components/responses/400_error.yaml
     '401':
@@ -108,7 +349,3 @@ delete:
       $ref: ../components/responses/invalid_request_error.yaml
     '500':
       $ref: ../components/responses/500_error.yaml
-  requestBody:
-    content:
-      application/json:
-        schema: {}

www/apps/api-reference/specs/store/paths/store_orders.yaml

@@ -0,0 +1,119 @@
+get:
+  operationId: GetOrders
+  summary: List Orders
+  description: >-
+    Retrieve a list of orders. The orders can be filtered by fields such as
+    `id`. The orders can also be sorted or paginated.
+  x-authenticated: false
+  parameters:
+    - name: expand
+      in: query
+      description: Comma-separated relations that should be expanded in the returned data.
+      required: false
+      schema:
+        type: string
+        title: expand
+        description: >-
+          Comma-separated relations that should be expanded in the returned
+          data.
+    - name: fields
+      in: query
+      description: |-
+        Comma-separated fields that should be included in the returned data.
+         * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+         * without prefix it will replace the entire default fields.
+      required: false
+      schema:
+        type: string
+        title: fields
+        description: |-
+          Comma-separated fields that should be included in the returned data.
+           * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+           * without prefix it will replace the entire default fields.
+    - name: offset
+      in: query
+      description: The number of items to skip when retrieving a list.
+      required: false
+      schema:
+        type: number
+        title: offset
+        description: The number of items to skip when retrieving a list.
+    - name: limit
+      in: query
+      description: Limit the number of items returned in the list.
+      required: false
+      schema:
+        type: number
+        title: limit
+        description: Limit the number of items returned in the list.
+    - name: order
+      in: query
+      description: >-
+        The field to sort the data by. By default, the sort order is ascending.
+        To change the order to descending, prefix the field name with `-`.
+      required: false
+      schema:
+        type: string
+        title: order
+        description: >-
+          The field to sort the data by. By default, the sort order is
+          ascending. To change the order to descending, prefix the field name
+          with `-`.
+    - name: id
+      in: query
+      required: false
+      schema:
+        oneOf:
+          - type: string
+            title: id
+            description: The order's ID.
+          - type: array
+            description: The order's ID.
+            items:
+              type: string
+              title: id
+              description: The id's ID.
+    - name: name
+      in: query
+      required: false
+      schema:
+        oneOf:
+          - type: string
+            title: name
+            description: The order's name.
+          - type: array
+            description: The order's name.
+            items:
+              type: string
+              title: name
+              description: The name's details.
+    - name: $and
+      in: query
+      required: false
+      schema: {}
+    - name: $or
+      in: query
+      required: false
+      schema: {}
+  x-codeSamples:
+    - lang: Shell
+      label: cURL
+      source:
+        $ref: ../code_samples/Shell/store_orders/get.sh
+  tags:
+    - Orders
+  responses:
+    '200':
+      description: OK
+    '400':
+      $ref: ../components/responses/400_error.yaml
+    '401':
+      $ref: ../components/responses/unauthorized.yaml
+    '404':
+      $ref: ../components/responses/not_found_error.yaml
+    '409':
+      $ref: ../components/responses/invalid_state_error.yaml
+    '422':
+      $ref: ../components/responses/invalid_request_error.yaml
+    '500':
+      $ref: ../components/responses/500_error.yaml

www/apps/api-reference/specs/store/paths/store_orders_{id}.yaml

@@ -0,0 +1,125 @@
+get:
+  operationId: GetOrdersId
+  summary: Get a Order
+  description: >-
+    Retrieve a order by its ID. You can expand the order's relations or select
+    the fields that should be returned.
+  x-authenticated: false
+  parameters:
+    - name: id
+      in: path
+      description: The order's ID.
+      required: true
+      schema:
+        type: string
+    - name: expand
+      in: query
+      description: Comma-separated relations that should be expanded in the returned data.
+      required: false
+      schema:
+        type: string
+        title: expand
+        description: >-
+          Comma-separated relations that should be expanded in the returned
+          data.
+    - name: fields
+      in: query
+      description: |-
+        Comma-separated fields that should be included in the returned data.
+         * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+         * without prefix it will replace the entire default fields.
+      required: false
+      schema:
+        type: string
+        title: fields
+        description: |-
+          Comma-separated fields that should be included in the returned data.
+           * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+           * without prefix it will replace the entire default fields.
+    - name: offset
+      in: query
+      description: The number of items to skip when retrieving a list.
+      required: false
+      schema:
+        type: number
+        title: offset
+        description: The number of items to skip when retrieving a list.
+    - name: limit
+      in: query
+      description: Limit the number of items returned in the list.
+      required: false
+      schema:
+        type: number
+        title: limit
+        description: Limit the number of items returned in the list.
+    - name: order
+      in: query
+      description: >-
+        The field to sort the data by. By default, the sort order is ascending.
+        To change the order to descending, prefix the field name with `-`.
+      required: false
+      schema:
+        type: string
+        title: order
+        description: >-
+          The field to sort the data by. By default, the sort order is
+          ascending. To change the order to descending, prefix the field name
+          with `-`.
+    - name: id
+      in: query
+      required: false
+      schema:
+        oneOf:
+          - type: string
+            title: id
+            description: The order's ID.
+          - type: array
+            description: The order's ID.
+            items:
+              type: string
+              title: id
+              description: The id's ID.
+    - name: status
+      in: query
+      required: false
+      schema:
+        oneOf:
+          - type: string
+            title: status
+            description: The order's status.
+          - type: array
+            description: The order's status.
+            items:
+              type: string
+              title: status
+              description: The status's details.
+    - name: $and
+      in: query
+      required: false
+      schema: {}
+    - name: $or
+      in: query
+      required: false
+      schema: {}
+  x-codeSamples:
+    - lang: Shell
+      label: cURL
+      source:
+        $ref: ../code_samples/Shell/store_orders_{id}/get.sh
+  tags:
+    - Orders
+  responses:
+    '200':
+      description: OK
+    '400':
+      $ref: ../components/responses/400_error.yaml
+    '401':
+      $ref: ../components/responses/unauthorized.yaml
+    '404':
+      $ref: ../components/responses/not_found_error.yaml
+    '409':
+      $ref: ../components/responses/invalid_state_error.yaml
+    '422':
+      $ref: ../components/responses/invalid_request_error.yaml
+    '500':
+      $ref: ../components/responses/500_error.yaml

www/apps/api-reference/specs/store/paths/store_payment-collections.yaml

@@ -0,0 +1,109 @@
+post:
+  operationId: PostPaymentCollections
+  summary: Create Payment Collection
+  description: Create a payment collection.
+  x-authenticated: false
+  parameters:
+    - name: expand
+      in: query
+      description: Comma-separated relations that should be expanded in the returned data.
+      required: false
+      schema:
+        type: string
+        title: expand
+        description: >-
+          Comma-separated relations that should be expanded in the returned
+          data.
+    - name: fields
+      in: query
+      description: |-
+        Comma-separated fields that should be included in the returned data.
+         * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+         * without prefix it will replace the entire default fields.
+      required: false
+      schema:
+        type: string
+        title: fields
+        description: |-
+          Comma-separated fields that should be included in the returned data.
+           * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+           * without prefix it will replace the entire default fields.
+    - name: offset
+      in: query
+      description: The number of items to skip when retrieving a list.
+      required: false
+      schema:
+        type: number
+        title: offset
+        description: The number of items to skip when retrieving a list.
+    - name: limit
+      in: query
+      description: Limit the number of items returned in the list.
+      required: false
+      schema:
+        type: number
+        title: limit
+        description: Limit the number of items returned in the list.
+    - name: order
+      in: query
+      description: >-
+        The field to sort the data by. By default, the sort order is ascending.
+        To change the order to descending, prefix the field name with `-`.
+      required: false
+      schema:
+        type: string
+        title: order
+        description: >-
+          The field to sort the data by. By default, the sort order is
+          ascending. To change the order to descending, prefix the field name
+          with `-`.
+  requestBody:
+    content:
+      application/json:
+        schema:
+          type: object
+          description: SUMMARY
+          required:
+            - cart_id
+            - region_id
+            - currency_code
+            - amount
+          properties:
+            cart_id:
+              type: string
+              title: cart_id
+              description: The payment collection's cart id.
+            region_id:
+              type: string
+              title: region_id
+              description: The payment collection's region id.
+            currency_code:
+              type: string
+              title: currency_code
+              description: The payment collection's currency code.
+            amount:
+              type: number
+              title: amount
+              description: The payment collection's amount.
+  x-codeSamples:
+    - lang: Shell
+      label: cURL
+      source:
+        $ref: ../code_samples/Shell/store_payment-collections/post.sh
+  tags:
+    - Payment Collections
+  responses:
+    '200':
+      description: OK
+    '400':
+      $ref: ../components/responses/400_error.yaml
+    '401':
+      $ref: ../components/responses/unauthorized.yaml
+    '404':
+      $ref: ../components/responses/not_found_error.yaml
+    '409':
+      $ref: ../components/responses/invalid_state_error.yaml
+    '422':
+      $ref: ../components/responses/invalid_request_error.yaml
+    '500':
+      $ref: ../components/responses/500_error.yaml

www/apps/api-reference/specs/store/paths/store_payment-collections_{id}_payment-sessions.yaml

@@ -10,12 +10,78 @@ post:
       required: true
       schema:
         type: string
+    - name: expand
+      in: query
+      description: Comma-separated relations that should be expanded in the returned data.
+      required: false
+      schema:
+        type: string
+        title: expand
+        description: >-
+          Comma-separated relations that should be expanded in the returned
+          data.
+    - name: fields
+      in: query
+      description: |-
+        Comma-separated fields that should be included in the returned data.
+         * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+         * without prefix it will replace the entire default fields.
+      required: false
+      schema:
+        type: string
+        title: fields
+        description: |-
+          Comma-separated fields that should be included in the returned data.
+           * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+           * without prefix it will replace the entire default fields.
+    - name: offset
+      in: query
+      description: The number of items to skip when retrieving a list.
+      required: false
+      schema:
+        type: number
+        title: offset
+        description: The number of items to skip when retrieving a list.
+    - name: limit
+      in: query
+      description: Limit the number of items returned in the list.
+      required: false
+      schema:
+        type: number
+        title: limit
+        description: Limit the number of items returned in the list.
+    - name: order
+      in: query
+      description: >-
+        The field to sort the data by. By default, the sort order is ascending.
+        To change the order to descending, prefix the field name with `-`.
+      required: false
+      schema:
+        type: string
+        title: order
+        description: >-
+          The field to sort the data by. By default, the sort order is
+          ascending. To change the order to descending, prefix the field name
+          with `-`.
   requestBody:
     content:
       application/json:
         schema:
-          $ref: >-
-            ../components/schemas/StorePostPaymentCollectionsPaymentSessionReq.yaml
+          type: object
+          description: SUMMARY
+          required:
+            - provider_id
+          properties:
+            provider_id:
+              type: string
+              title: provider_id
+              description: The payment collection's provider id.
+            context:
+              type: object
+              description: The payment collection's context.
+            data:
+              type: object
+              description: The payment collection's data.
   x-codeSamples:
     - lang: Shell
       label: cURL
@@ -25,6 +91,8 @@ post:
   tags:
     - Payment Collections
   responses:
+    '200':
+      description: OK
     '400':
       $ref: ../components/responses/400_error.yaml
     '401':

www/apps/api-reference/specs/store/paths/store_payment-providers.yaml

@@ -0,0 +1,122 @@
+get:
+  operationId: GetPaymentProviders
+  summary: List Payment Providers
+  description: >-
+    Retrieve a list of payment providers. The payment providers can be filtered
+    by fields such as `id`. The payment providers can also be sorted or
+    paginated.
+  x-authenticated: false
+  parameters:
+    - name: expand
+      in: query
+      description: Comma-separated relations that should be expanded in the returned data.
+      required: false
+      schema:
+        type: string
+        title: expand
+        description: >-
+          Comma-separated relations that should be expanded in the returned
+          data.
+    - name: fields
+      in: query
+      description: |-
+        Comma-separated fields that should be included in the returned data.
+         * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+         * without prefix it will replace the entire default fields.
+      required: false
+      schema:
+        type: string
+        title: fields
+        description: |-
+          Comma-separated fields that should be included in the returned data.
+           * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+           * without prefix it will replace the entire default fields.
+    - name: offset
+      in: query
+      description: The number of items to skip when retrieving a list.
+      required: false
+      schema:
+        type: number
+        title: offset
+        description: The number of items to skip when retrieving a list.
+    - name: limit
+      in: query
+      description: Limit the number of items returned in the list.
+      required: false
+      schema:
+        type: number
+        title: limit
+        description: Limit the number of items returned in the list.
+    - name: order
+      in: query
+      description: >-
+        The field to sort the data by. By default, the sort order is ascending.
+        To change the order to descending, prefix the field name with `-`.
+      required: false
+      schema:
+        type: string
+        title: order
+        description: >-
+          The field to sort the data by. By default, the sort order is
+          ascending. To change the order to descending, prefix the field name
+          with `-`.
+    - name: region_id
+      in: query
+      description: The payment provider's region id.
+      required: true
+      schema:
+        type: string
+        title: region_id
+        description: The payment provider's region id.
+    - name: id
+      in: query
+      required: false
+      schema:
+        oneOf:
+          - type: string
+            title: id
+            description: The payment provider's ID.
+          - type: array
+            description: The payment provider's ID.
+            items:
+              type: string
+              title: id
+              description: The id's ID.
+    - name: is_enabled
+      in: query
+      description: The payment provider's is enabled.
+      required: false
+      schema:
+        type: boolean
+        title: is_enabled
+        description: The payment provider's is enabled.
+    - name: $and
+      in: query
+      required: false
+      schema: {}
+    - name: $or
+      in: query
+      required: false
+      schema: {}
+  x-codeSamples:
+    - lang: Shell
+      label: cURL
+      source:
+        $ref: ../code_samples/Shell/store_payment-providers/get.sh
+  tags:
+    - Payment Providers
+  responses:
+    '200':
+      description: OK
+    '400':
+      $ref: ../components/responses/400_error.yaml
+    '401':
+      $ref: ../components/responses/unauthorized.yaml
+    '404':
+      $ref: ../components/responses/not_found_error.yaml
+    '409':
+      $ref: ../components/responses/invalid_state_error.yaml
+    '422':
+      $ref: ../components/responses/invalid_request_error.yaml
+    '500':
+      $ref: ../components/responses/500_error.yaml

www/apps/api-reference/specs/store/paths/store_product-categories.yaml

@@ -0,0 +1,275 @@
+get:
+  operationId: GetProductCategories
+  summary: List Product Categories
+  description: >-
+    Retrieve a list of product categories. The product categories can be
+    filtered by fields such as `id`. The product categories can also be sorted
+    or paginated.
+  x-authenticated: false
+  parameters:
+    - name: expand
+      in: query
+      description: Comma-separated relations that should be expanded in the returned data.
+      required: false
+      schema:
+        type: string
+        title: expand
+        description: >-
+          Comma-separated relations that should be expanded in the returned
+          data.
+    - name: fields
+      in: query
+      description: |-
+        Comma-separated fields that should be included in the returned data.
+         * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+         * without prefix it will replace the entire default fields.
+      required: false
+      schema:
+        type: string
+        title: fields
+        description: |-
+          Comma-separated fields that should be included in the returned data.
+           * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+           * without prefix it will replace the entire default fields.
+    - name: offset
+      in: query
+      description: The number of items to skip when retrieving a list.
+      required: false
+      schema:
+        type: number
+        title: offset
+        description: The number of items to skip when retrieving a list.
+    - name: limit
+      in: query
+      description: Limit the number of items returned in the list.
+      required: false
+      schema:
+        type: number
+        title: limit
+        description: Limit the number of items returned in the list.
+    - name: order
+      in: query
+      description: >-
+        The field to sort the data by. By default, the sort order is ascending.
+        To change the order to descending, prefix the field name with `-`.
+      required: false
+      schema:
+        type: string
+        title: order
+        description: >-
+          The field to sort the data by. By default, the sort order is
+          ascending. To change the order to descending, prefix the field name
+          with `-`.
+    - name: q
+      in: query
+      description: The product category's q.
+      required: false
+      schema:
+        type: string
+        title: q
+        description: The product category's q.
+    - name: id
+      in: query
+      required: false
+      schema:
+        oneOf:
+          - type: string
+            title: id
+            description: The product category's ID.
+          - type: array
+            description: The product category's ID.
+            items:
+              type: string
+              title: id
+              description: The id's ID.
+    - name: description
+      in: query
+      required: false
+      schema:
+        oneOf:
+          - type: string
+            title: description
+            description: The product category's description.
+          - type: array
+            description: The product category's description.
+            items:
+              type: string
+              title: description
+              description: The description's details.
+    - name: handle
+      in: query
+      required: false
+      schema:
+        oneOf:
+          - type: string
+            title: handle
+            description: The product category's handle.
+          - type: array
+            description: The product category's handle.
+            items:
+              type: string
+              title: handle
+              description: The handle's details.
+    - name: parent_category_id
+      in: query
+      required: false
+      schema:
+        oneOf:
+          - type: string
+            title: parent_category_id
+            description: The product category's parent category id.
+          - type: array
+            description: The product category's parent category id.
+            items:
+              type: string
+              title: parent_category_id
+              description: The parent category id's details.
+    - name: include_ancestors_tree
+      in: query
+      description: The product category's include ancestors tree.
+      required: true
+      schema:
+        type: boolean
+        title: include_ancestors_tree
+        description: The product category's include ancestors tree.
+    - name: include_descendants_tree
+      in: query
+      description: The product category's include descendants tree.
+      required: true
+      schema:
+        type: boolean
+        title: include_descendants_tree
+        description: The product category's include descendants tree.
+    - name: created_at
+      in: query
+      description: The product category's created at.
+      required: false
+      schema:
+        type: object
+        description: The product category's created at.
+        required:
+          - $eq
+          - $ne
+          - $in
+          - $nin
+          - $like
+          - $ilike
+          - $re
+          - $contains
+          - $gt
+          - $gte
+          - $lt
+          - $lte
+        properties:
+          $eq: {}
+          $ne: {}
+          $in: {}
+          $nin: {}
+          $like: {}
+          $ilike: {}
+          $re: {}
+          $contains: {}
+          $gt: {}
+          $gte: {}
+          $lt: {}
+          $lte: {}
+    - name: updated_at
+      in: query
+      description: The product category's updated at.
+      required: false
+      schema:
+        type: object
+        description: The product category's updated at.
+        required:
+          - $eq
+          - $ne
+          - $in
+          - $nin
+          - $like
+          - $ilike
+          - $re
+          - $contains
+          - $gt
+          - $gte
+          - $lt
+          - $lte
+        properties:
+          $eq: {}
+          $ne: {}
+          $in: {}
+          $nin: {}
+          $like: {}
+          $ilike: {}
+          $re: {}
+          $contains: {}
+          $gt: {}
+          $gte: {}
+          $lt: {}
+          $lte: {}
+    - name: deleted_at
+      in: query
+      description: The product category's deleted at.
+      required: false
+      schema:
+        type: object
+        description: The product category's deleted at.
+        required:
+          - $eq
+          - $ne
+          - $in
+          - $nin
+          - $like
+          - $ilike
+          - $re
+          - $contains
+          - $gt
+          - $gte
+          - $lt
+          - $lte
+        properties:
+          $eq: {}
+          $ne: {}
+          $in: {}
+          $nin: {}
+          $like: {}
+          $ilike: {}
+          $re: {}
+          $contains: {}
+          $gt: {}
+          $gte: {}
+          $lt: {}
+          $lte: {}
+    - name: $and
+      in: query
+      required: false
+      schema: {}
+    - name: $or
+      in: query
+      required: false
+      schema: {}
+  x-codeSamples:
+    - lang: Shell
+      label: cURL
+      source:
+        $ref: ../code_samples/Shell/store_product-categories/get.sh
+  tags:
+    - Product Categories
+  responses:
+    '200':
+      description: OK
+      content:
+        application/json:
+          schema:
+            $ref: ../components/schemas/StoreProductCategoryListResponse.yaml
+    '400':
+      $ref: ../components/responses/400_error.yaml
+    '401':
+      $ref: ../components/responses/unauthorized.yaml
+    '404':
+      $ref: ../components/responses/not_found_error.yaml
+    '409':
+      $ref: ../components/responses/invalid_state_error.yaml
+    '422':
+      $ref: ../components/responses/invalid_request_error.yaml
+    '500':
+      $ref: ../components/responses/500_error.yaml

www/apps/api-reference/specs/store/paths/store_product-categories_{id}.yaml

@@ -0,0 +1,109 @@
+get:
+  operationId: GetProductCategoriesId
+  summary: Get a Product Category
+  description: >-
+    Retrieve a product category by its ID. You can expand the product category's
+    relations or select the fields that should be returned.
+  x-authenticated: false
+  parameters:
+    - name: id
+      in: path
+      description: The product category's ID.
+      required: true
+      schema:
+        type: string
+    - name: expand
+      in: query
+      description: Comma-separated relations that should be expanded in the returned data.
+      required: false
+      schema:
+        type: string
+        title: expand
+        description: >-
+          Comma-separated relations that should be expanded in the returned
+          data.
+    - name: fields
+      in: query
+      description: |-
+        Comma-separated fields that should be included in the returned data.
+         * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+         * without prefix it will replace the entire default fields.
+      required: false
+      schema:
+        type: string
+        title: fields
+        description: |-
+          Comma-separated fields that should be included in the returned data.
+           * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+           * without prefix it will replace the entire default fields.
+    - name: offset
+      in: query
+      description: The number of items to skip when retrieving a list.
+      required: false
+      schema:
+        type: number
+        title: offset
+        description: The number of items to skip when retrieving a list.
+    - name: limit
+      in: query
+      description: Limit the number of items returned in the list.
+      required: false
+      schema:
+        type: number
+        title: limit
+        description: Limit the number of items returned in the list.
+    - name: order
+      in: query
+      description: >-
+        The field to sort the data by. By default, the sort order is ascending.
+        To change the order to descending, prefix the field name with `-`.
+      required: false
+      schema:
+        type: string
+        title: order
+        description: >-
+          The field to sort the data by. By default, the sort order is
+          ascending. To change the order to descending, prefix the field name
+          with `-`.
+    - name: include_ancestors_tree
+      in: query
+      description: The product category's include ancestors tree.
+      required: true
+      schema:
+        type: boolean
+        title: include_ancestors_tree
+        description: The product category's include ancestors tree.
+    - name: include_descendants_tree
+      in: query
+      description: The product category's include descendants tree.
+      required: true
+      schema:
+        type: boolean
+        title: include_descendants_tree
+        description: The product category's include descendants tree.
+  x-codeSamples:
+    - lang: Shell
+      label: cURL
+      source:
+        $ref: ../code_samples/Shell/store_product-categories_{id}/get.sh
+  tags:
+    - Product Categories
+  responses:
+    '200':
+      description: OK
+      content:
+        application/json:
+          schema:
+            $ref: ../components/schemas/StoreProductCategoryResponse.yaml
+    '400':
+      $ref: ../components/responses/400_error.yaml
+    '401':
+      $ref: ../components/responses/unauthorized.yaml
+    '404':
+      $ref: ../components/responses/not_found_error.yaml
+    '409':
+      $ref: ../components/responses/invalid_state_error.yaml
+    '422':
+      $ref: ../components/responses/invalid_request_error.yaml
+    '500':
+      $ref: ../components/responses/500_error.yaml

www/apps/api-reference/specs/store/paths/store_products.yaml

@@ -0,0 +1,342 @@
+get:
+  operationId: GetProducts
+  summary: List Products
+  description: >-
+    Retrieve a list of products. The products can be filtered by fields such as
+    `id`. The products can also be sorted or paginated.
+  x-authenticated: false
+  parameters:
+    - name: expand
+      in: query
+      description: Comma-separated relations that should be expanded in the returned data.
+      required: false
+      schema:
+        type: string
+        title: expand
+        description: >-
+          Comma-separated relations that should be expanded in the returned
+          data.
+    - name: fields
+      in: query
+      description: |-
+        Comma-separated fields that should be included in the returned data.
+         * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+         * without prefix it will replace the entire default fields.
+      required: false
+      schema:
+        type: string
+        title: fields
+        description: |-
+          Comma-separated fields that should be included in the returned data.
+           * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+           * without prefix it will replace the entire default fields.
+    - name: offset
+      in: query
+      description: The number of items to skip when retrieving a list.
+      required: false
+      schema:
+        type: number
+        title: offset
+        description: The number of items to skip when retrieving a list.
+    - name: limit
+      in: query
+      description: Limit the number of items returned in the list.
+      required: false
+      schema:
+        type: number
+        title: limit
+        description: Limit the number of items returned in the list.
+    - name: order
+      in: query
+      description: >-
+        The field to sort the data by. By default, the sort order is ascending.
+        To change the order to descending, prefix the field name with `-`.
+      required: false
+      schema:
+        type: string
+        title: order
+        description: >-
+          The field to sort the data by. By default, the sort order is
+          ascending. To change the order to descending, prefix the field name
+          with `-`.
+    - name: currency_code
+      in: query
+      description: The product's currency code.
+      required: false
+      schema:
+        type: string
+        title: currency_code
+        description: The product's currency code.
+    - name: region_id
+      in: query
+      description: The product's region id.
+      required: false
+      schema:
+        type: string
+        title: region_id
+        description: The product's region id.
+    - name: $and
+      in: query
+      required: false
+      schema: {}
+    - name: $or
+      in: query
+      required: false
+      schema: {}
+    - name: variants
+      in: query
+      description: The product's variants.
+      required: false
+      schema:
+        type: object
+        description: The product's variants.
+        properties:
+          status:
+            type: array
+            description: The variant's status.
+            items:
+              type: string
+              enum:
+                - draft
+                - proposed
+                - published
+                - rejected
+          options:
+            type: object
+            description: The variant's options.
+            required:
+              - value
+              - option_id
+            properties:
+              value:
+                type: string
+                title: value
+                description: The option's value.
+              option_id:
+                type: string
+                title: option_id
+                description: The option's option id.
+          $and: {}
+          $or: {}
+    - name: q
+      in: query
+      description: The product's q.
+      required: false
+      schema:
+        type: string
+        title: q
+        description: The product's q.
+    - name: id
+      in: query
+      required: false
+      schema:
+        oneOf:
+          - type: string
+            title: id
+            description: The product's ID.
+          - type: array
+            description: The product's ID.
+            items:
+              type: string
+              title: id
+              description: The id's ID.
+    - name: title
+      in: query
+      description: The product's title.
+      required: true
+      schema:
+        type: string
+        title: title
+        description: The product's title.
+    - name: handle
+      in: query
+      description: The product's handle.
+      required: true
+      schema:
+        type: string
+        title: handle
+        description: The product's handle.
+    - name: is_giftcard
+      in: query
+      description: The product's is giftcard.
+      required: true
+      schema:
+        type: boolean
+        title: is_giftcard
+        description: The product's is giftcard.
+    - name: category_id
+      in: query
+      description: The product's category id.
+      required: true
+      schema:
+        type: array
+        description: The product's category id.
+        items:
+          type: string
+          title: category_id
+          description: The category id's details.
+    - name: sales_channel_id
+      in: query
+      description: The product's sales channel id.
+      required: true
+      schema:
+        type: array
+        description: The product's sales channel id.
+        items:
+          type: string
+          title: sales_channel_id
+          description: The sales channel id's details.
+    - name: collection_id
+      in: query
+      description: The product's collection id.
+      required: true
+      schema:
+        type: array
+        description: The product's collection id.
+        items:
+          type: string
+          title: collection_id
+          description: The collection id's details.
+    - name: tags
+      in: query
+      description: The product's tags.
+      required: false
+      schema:
+        type: array
+        description: The product's tags.
+        items:
+          type: string
+          title: tags
+          description: The tag's tags.
+    - name: type_id
+      in: query
+      description: The product's type id.
+      required: false
+      schema:
+        type: array
+        description: The product's type id.
+        items:
+          type: string
+          title: type_id
+          description: The type id's details.
+    - name: created_at
+      in: query
+      description: The product's created at.
+      required: false
+      schema:
+        type: object
+        description: The product's created at.
+        required:
+          - $eq
+          - $ne
+          - $in
+          - $nin
+          - $like
+          - $ilike
+          - $re
+          - $contains
+          - $gt
+          - $gte
+          - $lt
+          - $lte
+        properties:
+          $eq: {}
+          $ne: {}
+          $in: {}
+          $nin: {}
+          $like: {}
+          $ilike: {}
+          $re: {}
+          $contains: {}
+          $gt: {}
+          $gte: {}
+          $lt: {}
+          $lte: {}
+    - name: updated_at
+      in: query
+      description: The product's updated at.
+      required: false
+      schema:
+        type: object
+        description: The product's updated at.
+        required:
+          - $eq
+          - $ne
+          - $in
+          - $nin
+          - $like
+          - $ilike
+          - $re
+          - $contains
+          - $gt
+          - $gte
+          - $lt
+          - $lte
+        properties:
+          $eq: {}
+          $ne: {}
+          $in: {}
+          $nin: {}
+          $like: {}
+          $ilike: {}
+          $re: {}
+          $contains: {}
+          $gt: {}
+          $gte: {}
+          $lt: {}
+          $lte: {}
+    - name: deleted_at
+      in: query
+      description: The product's deleted at.
+      required: false
+      schema:
+        type: object
+        description: The product's deleted at.
+        required:
+          - $eq
+          - $ne
+          - $in
+          - $nin
+          - $like
+          - $ilike
+          - $re
+          - $contains
+          - $gt
+          - $gte
+          - $lt
+          - $lte
+        properties:
+          $eq: {}
+          $ne: {}
+          $in: {}
+          $nin: {}
+          $like: {}
+          $ilike: {}
+          $re: {}
+          $contains: {}
+          $gt: {}
+          $gte: {}
+          $lt: {}
+          $lte: {}
+  x-codeSamples:
+    - lang: Shell
+      label: cURL
+      source:
+        $ref: ../code_samples/Shell/store_products/get.sh
+  tags:
+    - Products
+  responses:
+    '200':
+      description: OK
+    '400':
+      $ref: ../components/responses/400_error.yaml
+    '401':
+      $ref: ../components/responses/unauthorized.yaml
+    '404':
+      $ref: ../components/responses/not_found_error.yaml
+    '409':
+      $ref: ../components/responses/invalid_state_error.yaml
+    '422':
+      $ref: ../components/responses/invalid_request_error.yaml
+    '500':
+      $ref: ../components/responses/500_error.yaml

www/apps/api-reference/specs/store/paths/store_products_{id}.yaml

@@ -0,0 +1,348 @@
+get:
+  operationId: GetProductsId
+  summary: Get a Product
+  description: >-
+    Retrieve a product by its ID. You can expand the product's relations or
+    select the fields that should be returned.
+  x-authenticated: false
+  parameters:
+    - name: id
+      in: path
+      description: The product's ID.
+      required: true
+      schema:
+        type: string
+    - name: expand
+      in: query
+      description: Comma-separated relations that should be expanded in the returned data.
+      required: false
+      schema:
+        type: string
+        title: expand
+        description: >-
+          Comma-separated relations that should be expanded in the returned
+          data.
+    - name: fields
+      in: query
+      description: |-
+        Comma-separated fields that should be included in the returned data.
+         * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+         * without prefix it will replace the entire default fields.
+      required: false
+      schema:
+        type: string
+        title: fields
+        description: |-
+          Comma-separated fields that should be included in the returned data.
+           * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+           * without prefix it will replace the entire default fields.
+    - name: offset
+      in: query
+      description: The number of items to skip when retrieving a list.
+      required: false
+      schema:
+        type: number
+        title: offset
+        description: The number of items to skip when retrieving a list.
+    - name: limit
+      in: query
+      description: Limit the number of items returned in the list.
+      required: false
+      schema:
+        type: number
+        title: limit
+        description: Limit the number of items returned in the list.
+    - name: order
+      in: query
+      description: >-
+        The field to sort the data by. By default, the sort order is ascending.
+        To change the order to descending, prefix the field name with `-`.
+      required: false
+      schema:
+        type: string
+        title: order
+        description: >-
+          The field to sort the data by. By default, the sort order is
+          ascending. To change the order to descending, prefix the field name
+          with `-`.
+    - name: currency_code
+      in: query
+      description: The product's currency code.
+      required: false
+      schema:
+        type: string
+        title: currency_code
+        description: The product's currency code.
+    - name: region_id
+      in: query
+      description: The product's region id.
+      required: false
+      schema:
+        type: string
+        title: region_id
+        description: The product's region id.
+    - name: $and
+      in: query
+      required: false
+      schema: {}
+    - name: $or
+      in: query
+      required: false
+      schema: {}
+    - name: variants
+      in: query
+      description: The product's variants.
+      required: false
+      schema:
+        type: object
+        description: The product's variants.
+        properties:
+          status:
+            type: array
+            description: The variant's status.
+            items:
+              type: string
+              enum:
+                - draft
+                - proposed
+                - published
+                - rejected
+          options:
+            type: object
+            description: The variant's options.
+            required:
+              - value
+              - option_id
+            properties:
+              value:
+                type: string
+                title: value
+                description: The option's value.
+              option_id:
+                type: string
+                title: option_id
+                description: The option's option id.
+          $and: {}
+          $or: {}
+    - name: q
+      in: query
+      description: The product's q.
+      required: false
+      schema:
+        type: string
+        title: q
+        description: The product's q.
+    - name: id
+      in: query
+      required: false
+      schema:
+        oneOf:
+          - type: string
+            title: id
+            description: The product's ID.
+          - type: array
+            description: The product's ID.
+            items:
+              type: string
+              title: id
+              description: The id's ID.
+    - name: title
+      in: query
+      description: The product's title.
+      required: true
+      schema:
+        type: string
+        title: title
+        description: The product's title.
+    - name: handle
+      in: query
+      description: The product's handle.
+      required: true
+      schema:
+        type: string
+        title: handle
+        description: The product's handle.
+    - name: is_giftcard
+      in: query
+      description: The product's is giftcard.
+      required: true
+      schema:
+        type: boolean
+        title: is_giftcard
+        description: The product's is giftcard.
+    - name: category_id
+      in: query
+      description: The product's category id.
+      required: true
+      schema:
+        type: array
+        description: The product's category id.
+        items:
+          type: string
+          title: category_id
+          description: The category id's details.
+    - name: sales_channel_id
+      in: query
+      description: The product's sales channel id.
+      required: true
+      schema:
+        type: array
+        description: The product's sales channel id.
+        items:
+          type: string
+          title: sales_channel_id
+          description: The sales channel id's details.
+    - name: collection_id
+      in: query
+      description: The product's collection id.
+      required: true
+      schema:
+        type: array
+        description: The product's collection id.
+        items:
+          type: string
+          title: collection_id
+          description: The collection id's details.
+    - name: tags
+      in: query
+      description: The product's tags.
+      required: false
+      schema:
+        type: array
+        description: The product's tags.
+        items:
+          type: string
+          title: tags
+          description: The tag's tags.
+    - name: type_id
+      in: query
+      description: The product's type id.
+      required: false
+      schema:
+        type: array
+        description: The product's type id.
+        items:
+          type: string
+          title: type_id
+          description: The type id's details.
+    - name: created_at
+      in: query
+      description: The product's created at.
+      required: false
+      schema:
+        type: object
+        description: The product's created at.
+        required:
+          - $eq
+          - $ne
+          - $in
+          - $nin
+          - $like
+          - $ilike
+          - $re
+          - $contains
+          - $gt
+          - $gte
+          - $lt
+          - $lte
+        properties:
+          $eq: {}
+          $ne: {}
+          $in: {}
+          $nin: {}
+          $like: {}
+          $ilike: {}
+          $re: {}
+          $contains: {}
+          $gt: {}
+          $gte: {}
+          $lt: {}
+          $lte: {}
+    - name: updated_at
+      in: query
+      description: The product's updated at.
+      required: false
+      schema:
+        type: object
+        description: The product's updated at.
+        required:
+          - $eq
+          - $ne
+          - $in
+          - $nin
+          - $like
+          - $ilike
+          - $re
+          - $contains
+          - $gt
+          - $gte
+          - $lt
+          - $lte
+        properties:
+          $eq: {}
+          $ne: {}
+          $in: {}
+          $nin: {}
+          $like: {}
+          $ilike: {}
+          $re: {}
+          $contains: {}
+          $gt: {}
+          $gte: {}
+          $lt: {}
+          $lte: {}
+    - name: deleted_at
+      in: query
+      description: The product's deleted at.
+      required: false
+      schema:
+        type: object
+        description: The product's deleted at.
+        required:
+          - $eq
+          - $ne
+          - $in
+          - $nin
+          - $like
+          - $ilike
+          - $re
+          - $contains
+          - $gt
+          - $gte
+          - $lt
+          - $lte
+        properties:
+          $eq: {}
+          $ne: {}
+          $in: {}
+          $nin: {}
+          $like: {}
+          $ilike: {}
+          $re: {}
+          $contains: {}
+          $gt: {}
+          $gte: {}
+          $lt: {}
+          $lte: {}
+  x-codeSamples:
+    - lang: Shell
+      label: cURL
+      source:
+        $ref: ../code_samples/Shell/store_products_{id}/get.sh
+  tags:
+    - Products
+  responses:
+    '200':
+      description: OK
+    '400':
+      $ref: ../components/responses/400_error.yaml
+    '401':
+      $ref: ../components/responses/unauthorized.yaml
+    '404':
+      $ref: ../components/responses/not_found_error.yaml
+    '409':
+      $ref: ../components/responses/invalid_state_error.yaml
+    '422':
+      $ref: ../components/responses/invalid_request_error.yaml
+    '500':
+      $ref: ../components/responses/500_error.yaml

www/apps/api-reference/specs/store/paths/store_regions.yaml

@@ -5,7 +5,60 @@ get:
     Retrieve a list of regions. The regions can be filtered by fields such as
     `id`. The regions can also be sorted or paginated.
   x-authenticated: false
-  parameters: []
+  parameters:
+    - name: expand
+      in: query
+      description: Comma-separated relations that should be expanded in the returned data.
+      required: false
+      schema:
+        type: string
+        title: expand
+        description: >-
+          Comma-separated relations that should be expanded in the returned
+          data.
+    - name: fields
+      in: query
+      description: |-
+        Comma-separated fields that should be included in the returned data.
+         * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+         * without prefix it will replace the entire default fields.
+      required: false
+      schema:
+        type: string
+        title: fields
+        description: |-
+          Comma-separated fields that should be included in the returned data.
+           * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+           * without prefix it will replace the entire default fields.
+    - name: offset
+      in: query
+      description: The number of items to skip when retrieving a list.
+      required: false
+      schema:
+        type: number
+        title: offset
+        description: The number of items to skip when retrieving a list.
+    - name: limit
+      in: query
+      description: Limit the number of items returned in the list.
+      required: false
+      schema:
+        type: number
+        title: limit
+        description: Limit the number of items returned in the list.
+    - name: order
+      in: query
+      description: >-
+        The field to sort the data by. By default, the sort order is ascending.
+        To change the order to descending, prefix the field name with `-`.
+      required: false
+      schema:
+        type: string
+        title: order
+        description: >-
+          The field to sort the data by. By default, the sort order is
+          ascending. To change the order to descending, prefix the field name
+          with `-`.
   x-codeSamples:
     - lang: Shell
       label: cURL
@@ -14,6 +67,8 @@ get:
   tags:
     - Regions
   responses:
+    '200':
+      description: OK
     '400':
       $ref: ../components/responses/400_error.yaml
     '401':
@@ -26,7 +81,3 @@ get:
       $ref: ../components/responses/invalid_request_error.yaml
     '500':
       $ref: ../components/responses/500_error.yaml
-  requestBody:
-    content:
-      application/json:
-        schema: {}

www/apps/api-reference/specs/store/paths/store_regions_{id}.yaml

@@ -12,6 +12,59 @@ get:
       required: true
       schema:
         type: string
+    - name: expand
+      in: query
+      description: Comma-separated relations that should be expanded in the returned data.
+      required: false
+      schema:
+        type: string
+        title: expand
+        description: >-
+          Comma-separated relations that should be expanded in the returned
+          data.
+    - name: fields
+      in: query
+      description: |-
+        Comma-separated fields that should be included in the returned data.
+         * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+         * without prefix it will replace the entire default fields.
+      required: false
+      schema:
+        type: string
+        title: fields
+        description: |-
+          Comma-separated fields that should be included in the returned data.
+           * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+           * without prefix it will replace the entire default fields.
+    - name: offset
+      in: query
+      description: The number of items to skip when retrieving a list.
+      required: false
+      schema:
+        type: number
+        title: offset
+        description: The number of items to skip when retrieving a list.
+    - name: limit
+      in: query
+      description: Limit the number of items returned in the list.
+      required: false
+      schema:
+        type: number
+        title: limit
+        description: Limit the number of items returned in the list.
+    - name: order
+      in: query
+      description: >-
+        The field to sort the data by. By default, the sort order is ascending.
+        To change the order to descending, prefix the field name with `-`.
+      required: false
+      schema:
+        type: string
+        title: order
+        description: >-
+          The field to sort the data by. By default, the sort order is
+          ascending. To change the order to descending, prefix the field name
+          with `-`.
   x-codeSamples:
     - lang: Shell
       label: cURL
@@ -20,6 +73,8 @@ get:
   tags:
     - Regions
   responses:
+    '200':
+      description: OK
     '400':
       $ref: ../components/responses/400_error.yaml
     '401':
@@ -32,7 +87,3 @@ get:
       $ref: ../components/responses/invalid_request_error.yaml
     '500':
       $ref: ../components/responses/500_error.yaml
-  requestBody:
-    content:
-      application/json:
-        schema: {}

www/apps/api-reference/specs/store/paths/store_regions_{id}_payment-providers.yaml

@@ -1,39 +0,0 @@
-get:
-  operationId: GetRegionsIdPaymentProviders
-  summary: List Payment Providers
-  description: >-
-    Retrieve a list of payment providers in a region. The payment providers can
-    be filtered by fields like FILTER FIELDS. The payment providers can also be
-    paginated.
-  x-authenticated: false
-  parameters:
-    - name: id
-      in: path
-      description: The region's ID.
-      required: true
-      schema:
-        type: string
-  x-codeSamples:
-    - lang: Shell
-      label: cURL
-      source:
-        $ref: ../code_samples/Shell/store_regions_{id}_payment-providers/get.sh
-  tags:
-    - Regions
-  responses:
-    '400':
-      $ref: ../components/responses/400_error.yaml
-    '401':
-      $ref: ../components/responses/unauthorized.yaml
-    '404':
-      $ref: ../components/responses/not_found_error.yaml
-    '409':
-      $ref: ../components/responses/invalid_state_error.yaml
-    '422':
-      $ref: ../components/responses/invalid_request_error.yaml
-    '500':
-      $ref: ../components/responses/500_error.yaml
-  requestBody:
-    content:
-      application/json:
-        schema: {}

www/apps/api-reference/specs/store/paths/store_return-reasons.yaml

@@ -0,0 +1,83 @@
+get:
+  operationId: GetReturnReasons
+  summary: List Return Reasons
+  description: >-
+    Retrieve a list of return reasons. The return reasons can be filtered by
+    fields such as `id`. The return reasons can also be sorted or paginated.
+  x-authenticated: false
+  parameters:
+    - name: expand
+      in: query
+      description: Comma-separated relations that should be expanded in the returned data.
+      required: false
+      schema:
+        type: string
+        title: expand
+        description: >-
+          Comma-separated relations that should be expanded in the returned
+          data.
+    - name: fields
+      in: query
+      description: |-
+        Comma-separated fields that should be included in the returned data.
+         * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+         * without prefix it will replace the entire default fields.
+      required: false
+      schema:
+        type: string
+        title: fields
+        description: |-
+          Comma-separated fields that should be included in the returned data.
+           * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+           * without prefix it will replace the entire default fields.
+    - name: offset
+      in: query
+      description: The number of items to skip when retrieving a list.
+      required: false
+      schema:
+        type: number
+        title: offset
+        description: The number of items to skip when retrieving a list.
+    - name: limit
+      in: query
+      description: Limit the number of items returned in the list.
+      required: false
+      schema:
+        type: number
+        title: limit
+        description: Limit the number of items returned in the list.
+    - name: order
+      in: query
+      description: >-
+        The field to sort the data by. By default, the sort order is ascending.
+        To change the order to descending, prefix the field name with `-`.
+      required: false
+      schema:
+        type: string
+        title: order
+        description: >-
+          The field to sort the data by. By default, the sort order is
+          ascending. To change the order to descending, prefix the field name
+          with `-`.
+  x-codeSamples:
+    - lang: Shell
+      label: cURL
+      source:
+        $ref: ../code_samples/Shell/store_return-reasons/get.sh
+  tags:
+    - Return Reasons
+  responses:
+    '200':
+      description: OK
+    '400':
+      $ref: ../components/responses/400_error.yaml
+    '401':
+      $ref: ../components/responses/unauthorized.yaml
+    '404':
+      $ref: ../components/responses/not_found_error.yaml
+    '409':
+      $ref: ../components/responses/invalid_state_error.yaml
+    '422':
+      $ref: ../components/responses/invalid_request_error.yaml
+    '500':
+      $ref: ../components/responses/500_error.yaml

www/apps/api-reference/specs/store/paths/store_return-reasons_{id}.yaml

@@ -0,0 +1,89 @@
+get:
+  operationId: GetReturnReasonsId
+  summary: Get a Return Reason
+  description: >-
+    Retrieve a return reason by its ID. You can expand the return reason's
+    relations or select the fields that should be returned.
+  x-authenticated: false
+  parameters:
+    - name: id
+      in: path
+      description: The return reason's ID.
+      required: true
+      schema:
+        type: string
+    - name: expand
+      in: query
+      description: Comma-separated relations that should be expanded in the returned data.
+      required: false
+      schema:
+        type: string
+        title: expand
+        description: >-
+          Comma-separated relations that should be expanded in the returned
+          data.
+    - name: fields
+      in: query
+      description: |-
+        Comma-separated fields that should be included in the returned data.
+         * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+         * without prefix it will replace the entire default fields.
+      required: false
+      schema:
+        type: string
+        title: fields
+        description: |-
+          Comma-separated fields that should be included in the returned data.
+           * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+           * without prefix it will replace the entire default fields.
+    - name: offset
+      in: query
+      description: The number of items to skip when retrieving a list.
+      required: false
+      schema:
+        type: number
+        title: offset
+        description: The number of items to skip when retrieving a list.
+    - name: limit
+      in: query
+      description: Limit the number of items returned in the list.
+      required: false
+      schema:
+        type: number
+        title: limit
+        description: Limit the number of items returned in the list.
+    - name: order
+      in: query
+      description: >-
+        The field to sort the data by. By default, the sort order is ascending.
+        To change the order to descending, prefix the field name with `-`.
+      required: false
+      schema:
+        type: string
+        title: order
+        description: >-
+          The field to sort the data by. By default, the sort order is
+          ascending. To change the order to descending, prefix the field name
+          with `-`.
+  x-codeSamples:
+    - lang: Shell
+      label: cURL
+      source:
+        $ref: ../code_samples/Shell/store_return-reasons_{id}/get.sh
+  tags:
+    - Return Reasons
+  responses:
+    '200':
+      description: OK
+    '400':
+      $ref: ../components/responses/400_error.yaml
+    '401':
+      $ref: ../components/responses/unauthorized.yaml
+    '404':
+      $ref: ../components/responses/not_found_error.yaml
+    '409':
+      $ref: ../components/responses/invalid_state_error.yaml
+    '422':
+      $ref: ../components/responses/invalid_request_error.yaml
+    '500':
+      $ref: ../components/responses/500_error.yaml

www/apps/api-reference/specs/store/paths/store_return.yaml

@@ -0,0 +1,86 @@
+post:
+  operationId: PostReturn
+  summary: Create Return
+  description: Create a return.
+  x-authenticated: false
+  parameters:
+    - name: expand
+      in: query
+      description: Comma-separated relations that should be expanded in the returned data.
+      required: false
+      schema:
+        type: string
+        title: expand
+        description: >-
+          Comma-separated relations that should be expanded in the returned
+          data.
+    - name: fields
+      in: query
+      description: |-
+        Comma-separated fields that should be included in the returned data.
+         * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+         * without prefix it will replace the entire default fields.
+      required: false
+      schema:
+        type: string
+        title: fields
+        description: |-
+          Comma-separated fields that should be included in the returned data.
+           * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+           * without prefix it will replace the entire default fields.
+    - name: offset
+      in: query
+      description: The number of items to skip when retrieving a list.
+      required: false
+      schema:
+        type: number
+        title: offset
+        description: The number of items to skip when retrieving a list.
+    - name: limit
+      in: query
+      description: Limit the number of items returned in the list.
+      required: false
+      schema:
+        type: number
+        title: limit
+        description: Limit the number of items returned in the list.
+    - name: order
+      in: query
+      description: >-
+        The field to sort the data by. By default, the sort order is ascending.
+        To change the order to descending, prefix the field name with `-`.
+      required: false
+      schema:
+        type: string
+        title: order
+        description: >-
+          The field to sort the data by. By default, the sort order is
+          ascending. To change the order to descending, prefix the field name
+          with `-`.
+  requestBody:
+    content:
+      application/json:
+        schema:
+          $ref: ../components/schemas/StorePostReturnsReqSchema.yaml
+  x-codeSamples:
+    - lang: Shell
+      label: cURL
+      source:
+        $ref: ../code_samples/Shell/store_return/post.sh
+  tags:
+    - Return
+  responses:
+    '200':
+      description: OK
+    '400':
+      $ref: ../components/responses/400_error.yaml
+    '401':
+      $ref: ../components/responses/unauthorized.yaml
+    '404':
+      $ref: ../components/responses/not_found_error.yaml
+    '409':
+      $ref: ../components/responses/invalid_state_error.yaml
+    '422':
+      $ref: ../components/responses/invalid_request_error.yaml
+    '500':
+      $ref: ../components/responses/500_error.yaml

www/apps/api-reference/specs/store/paths/store_shipping-options.yaml

@@ -0,0 +1,83 @@
+get:
+  operationId: GetShippingOptions
+  summary: List Shipping Options
+  description: >-
+    Retrieve a list of shipping options. The shipping options can be filtered by
+    fields such as `id`. The shipping options can also be sorted or paginated.
+  x-authenticated: false
+  parameters:
+    - name: expand
+      in: query
+      description: Comma-separated relations that should be expanded in the returned data.
+      required: false
+      schema:
+        type: string
+        title: expand
+        description: >-
+          Comma-separated relations that should be expanded in the returned
+          data.
+    - name: fields
+      in: query
+      description: |-
+        Comma-separated fields that should be included in the returned data.
+         * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+         * without prefix it will replace the entire default fields.
+      required: false
+      schema:
+        type: string
+        title: fields
+        description: |-
+          Comma-separated fields that should be included in the returned data.
+           * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
+           * without prefix it will replace the entire default fields.
+    - name: offset
+      in: query
+      description: The number of items to skip when retrieving a list.
+      required: false
+      schema:
+        type: number
+        title: offset
+        description: The number of items to skip when retrieving a list.
+    - name: limit
+      in: query
+      description: Limit the number of items returned in the list.
+      required: false
+      schema:
+        type: number
+        title: limit
+        description: Limit the number of items returned in the list.
+    - name: order
+      in: query
+      description: >-
+        The field to sort the data by. By default, the sort order is ascending.
+        To change the order to descending, prefix the field name with `-`.
+      required: false
+      schema:
+        type: string
+        title: order
+        description: >-
+          The field to sort the data by. By default, the sort order is
+          ascending. To change the order to descending, prefix the field name
+          with `-`.
+  x-codeSamples:
+    - lang: Shell
+      label: cURL
+      source:
+        $ref: ../code_samples/Shell/store_shipping-options/get.sh
+  tags:
+    - Shipping Options
+  responses:
+    '200':
+      description: OK
+    '400':
+      $ref: ../components/responses/400_error.yaml
+    '401':
+      $ref: ../components/responses/unauthorized.yaml
+    '404':
+      $ref: ../components/responses/not_found_error.yaml
+    '409':
+      $ref: ../components/responses/invalid_state_error.yaml
+    '422':
+      $ref: ../components/responses/invalid_request_error.yaml
+    '500':
+      $ref: ../components/responses/500_error.yaml

www/apps/api-reference/specs/store/paths/store_shipping-options_{cart_id}.yaml

@@ -1,38 +0,0 @@
-get:
-  operationId: GetShippingOptionsCart_id
-  summary: Get a Shipping Option
-  description: >-
-    Retrieve a shipping option by its ID. You can expand the shipping option's
-    relations or select the fields that should be returned.
-  x-authenticated: false
-  parameters:
-    - name: cart_id
-      in: path
-      description: The shipping option's cart id.
-      required: true
-      schema:
-        type: string
-  x-codeSamples:
-    - lang: Shell
-      label: cURL
-      source:
-        $ref: ../code_samples/Shell/store_shipping-options_{cart_id}/get.sh
-  tags:
-    - Shipping Options
-  responses:
-    '400':
-      $ref: ../components/responses/400_error.yaml
-    '401':
-      $ref: ../components/responses/unauthorized.yaml
-    '404':
-      $ref: ../components/responses/not_found_error.yaml
-    '409':
-      $ref: ../components/responses/invalid_state_error.yaml
-    '422':
-      $ref: ../components/responses/invalid_request_error.yaml
-    '500':
-      $ref: ../components/responses/500_error.yaml
-  requestBody:
-    content:
-      application/json:
-        schema: {}