chore(docs): Generated API Reference (#3061)

Co-authored-by: olivermrbl <olivermrbl@users.noreply.github.com>
2023-01-19 10:06:17 +02:00
parent 3a0f37ef02
commit 296d6e229f
375 changed files with 8467 additions and 5775 deletions
--- a/docs/api/store/paths/auth.yaml
+++ b/docs/api/store/paths/auth.yaml
@@ -22,10 +22,7 @@ post:
      content:
        application/json:
          schema:
-            type: object
-            properties:
-              customer:
-                $ref: ../components/schemas/Customer.yaml
+            $ref: ../components/schemas/StoreAuthRes.yaml
    '400':
      $ref: ../components/responses/400_error.yaml
    '401':
@@ -106,10 +103,7 @@ get:
      content:
        application/json:
          schema:
-            type: object
-            properties:
-              customer:
-                $ref: ../components/schemas/Customer.yaml
+            $ref: ../components/schemas/StoreAuthRes.yaml
    '400':
      $ref: ../components/responses/400_error.yaml
    '401':
--- a/docs/api/store/paths/auth_{email}.yaml
+++ b/docs/api/store/paths/auth_{email}.yaml
@@ -27,11 +27,7 @@ get:
      content:
        application/json:
          schema:
-            type: object
-            properties:
-              exists:
-                type: boolean
-                description: Whether email exists or not.
+            $ref: ../components/schemas/StoreGetAuthEmailRes.yaml
    '400':
      $ref: ../components/responses/400_error.yaml
    '404':
--- a/docs/api/store/paths/carts.yaml
+++ b/docs/api/store/paths/carts.yaml
@@ -28,10 +28,7 @@ post:
      content:
        application/json:
          schema:
-            type: object
-            properties:
-              cart:
-                $ref: ../components/schemas/Cart.yaml
+            $ref: ../components/schemas/StoreCartsRes.yaml
    '400':
      $ref: ../components/responses/400_error.yaml
    '404':
--- a/docs/api/store/paths/carts_{id}.yaml
+++ b/docs/api/store/paths/carts_{id}.yaml
@@ -26,10 +26,7 @@ get:
      content:
        application/json:
          schema:
-            type: object
-            properties:
-              cart:
-                $ref: ../components/schemas/Cart.yaml
+            $ref: ../components/schemas/StoreCartsRes.yaml
    '400':
      $ref: ../components/responses/400_error.yaml
    '404':
@@ -73,10 +70,7 @@ post:
      content:
        application/json:
          schema:
-            type: object
-            properties:
-              cart:
-                $ref: ../components/schemas/Cart.yaml
+            $ref: ../components/schemas/StoreCartsRes.yaml
    '400':
      $ref: ../components/responses/400_error.yaml
    '404':
--- a/docs/api/store/paths/carts_{id}_complete.yaml
+++ b/docs/api/store/paths/carts_{id}_complete.yaml
@@ -36,42 +36,7 @@ post:
      content:
        application/json:
          schema:
-            type: object
-            properties:
-              type:
-                type: string
-                description: The type of the data property.
-                enum:
-                  - order
-                  - cart
-                  - swap
-              data:
-                type: object
-                description: >-
-                  The data of the result object. Its type depends on the type
-                  field.
-                oneOf:
-                  - type: object
-                    description: >-
-                      Cart was successfully authorized and order was placed
-                      successfully.
-                    properties:
-                      order:
-                        $ref: ../components/schemas/Order.yaml
-                  - type: object
-                    description: >-
-                      Cart was successfully authorized but requires further
-                      actions.
-                    properties:
-                      cart:
-                        $ref: ../components/schemas/Cart.yaml
-                  - type: object
-                    description: >-
-                      When cart is used for a swap and it has been completed
-                      successfully.
-                    properties:
-                      cart:
-                        $ref: ../components/schemas/Swap.yaml
+            $ref: ../components/schemas/StoreCompleteCartRes.yaml
    '400':
      $ref: ../components/responses/400_error.yaml
    '404':
--- a/docs/api/store/paths/carts_{id}_discounts_{code}.yaml
+++ b/docs/api/store/paths/carts_{id}_discounts_{code}.yaml
@@ -32,10 +32,7 @@ delete:
      content:
        application/json:
          schema:
-            type: object
-            properties:
-              cart:
-                $ref: ../components/schemas/Cart.yaml
+            $ref: ../components/schemas/StoreCartsRes.yaml
    '400':
      $ref: ../components/responses/400_error.yaml
    '404':
--- a/docs/api/store/paths/carts_{id}_line-items.yaml
+++ b/docs/api/store/paths/carts_{id}_line-items.yaml
@@ -26,10 +26,7 @@ post:
      content:
        application/json:
          schema:
-            type: object
-            properties:
-              cart:
-                $ref: ../components/schemas/Cart.yaml
+            $ref: ../components/schemas/StoreCartsRes.yaml
    '400':
      $ref: ../components/responses/400_error.yaml
    '404':
--- a/docs/api/store/paths/carts_{id}_line-items_{line_id}.yaml
+++ b/docs/api/store/paths/carts_{id}_line-items_{line_id}.yaml
@@ -33,10 +33,7 @@ delete:
      content:
        application/json:
          schema:
-            type: object
-            properties:
-              cart:
-                $ref: ../components/schemas/Cart.yaml
+            $ref: ../components/schemas/StoreCartsRes.yaml
    '400':
      $ref: ../components/responses/400_error.yaml
    '404':
@@ -82,10 +79,7 @@ post:
      content:
        application/json:
          schema:
-            type: object
-            properties:
-              cart:
-                $ref: ../components/schemas/Cart.yaml
+            $ref: ../components/schemas/StoreCartsRes.yaml
    '400':
      $ref: ../components/responses/400_error.yaml
    '404':
--- a/docs/api/store/paths/carts_{id}_payment-session.yaml
+++ b/docs/api/store/paths/carts_{id}_payment-session.yaml
@@ -28,10 +28,7 @@ post:
      content:
        application/json:
          schema:
-            type: object
-            properties:
-              cart:
-                $ref: ../components/schemas/Cart.yaml
+            $ref: ../components/schemas/StoreCartsRes.yaml
    '400':
      $ref: ../components/responses/400_error.yaml
    '404':
--- a/docs/api/store/paths/carts_{id}_payment-sessions.yaml
+++ b/docs/api/store/paths/carts_{id}_payment-sessions.yaml
@@ -28,10 +28,7 @@ post:
      content:
        application/json:
          schema:
-            type: object
-            properties:
-              cart:
-                $ref: ../components/schemas/Cart.yaml
+            $ref: ../components/schemas/StoreCartsRes.yaml
    '400':
      $ref: ../components/responses/400_error.yaml
    '404':
--- a/docs/api/store/paths/carts_{id}_payment-sessions_{provider_id}.yaml
+++ b/docs/api/store/paths/carts_{id}_payment-sessions_{provider_id}.yaml
@@ -36,10 +36,7 @@ delete:
      content:
        application/json:
          schema:
-            type: object
-            properties:
-              cart:
-                $ref: ../components/schemas/Cart.yaml
+            $ref: ../components/schemas/StoreCartsRes.yaml
    '400':
      $ref: ../components/responses/400_error.yaml
    '404':
@@ -86,10 +83,7 @@ post:
      content:
        application/json:
          schema:
-            type: object
-            properties:
-              cart:
-                $ref: ../components/schemas/Cart.yaml
+            $ref: ../components/schemas/StoreCartsRes.yaml
    '400':
      $ref: ../components/responses/400_error.yaml
    '404':
--- a/docs/api/store/paths/carts_{id}_payment-sessions_{provider_id}_refresh.yaml
+++ b/docs/api/store/paths/carts_{id}_payment-sessions_{provider_id}_refresh.yaml
@@ -38,10 +38,7 @@ post:
      content:
        application/json:
          schema:
-            type: object
-            properties:
-              cart:
-                $ref: ../components/schemas/Cart.yaml
+            $ref: ../components/schemas/StoreCartsRes.yaml
    '400':
      $ref: ../components/responses/400_error.yaml
    '404':
--- a/docs/api/store/paths/carts_{id}_shipping-methods.yaml
+++ b/docs/api/store/paths/carts_{id}_shipping-methods.yaml
@@ -26,10 +26,7 @@ post:
      content:
        application/json:
          schema:
-            type: object
-            properties:
-              cart:
-                $ref: ../components/schemas/Cart.yaml
+            $ref: ../components/schemas/StoreCartsRes.yaml
    '400':
      $ref: ../components/responses/400_error.yaml
    '404':
--- a/docs/api/store/paths/carts_{id}_taxes.yaml
+++ b/docs/api/store/paths/carts_{id}_taxes.yaml
@@ -24,10 +24,7 @@ post:
      content:
        application/json:
          schema:
-            type: object
-            properties:
-              cart:
-                $ref: ../components/schemas/Cart.yaml
+            $ref: ../components/schemas/StoreCartsRes.yaml
    '400':
      $ref: ../components/responses/400_error.yaml
    '404':
--- a/docs/api/store/paths/collections.yaml
+++ b/docs/api/store/paths/collections.yaml
@@ -78,21 +78,7 @@ get:
      content:
        application/json:
          schema:
-            type: object
-            properties:
-              collections:
-                type: array
-                items:
-                  $ref: ../components/schemas/ProductCollection.yaml
-              count:
-                type: integer
-                description: The total number of items available
-              offset:
-                type: integer
-                description: The number of items skipped before these items
-              limit:
-                type: integer
-                description: The number of items per page
+            $ref: ../components/schemas/StoreCollectionsListRes.yaml
    '400':
      $ref: ../components/responses/400_error.yaml
    '404':
--- a/docs/api/store/paths/collections_{id}.yaml
+++ b/docs/api/store/paths/collections_{id}.yaml
@@ -26,10 +26,7 @@ get:
      content:
        application/json:
          schema:
-            type: object
-            properties:
-              collection:
-                $ref: ../components/schemas/ProductCollection.yaml
+            $ref: ../components/schemas/StoreCollectionsRes.yaml
    '400':
      $ref: ../components/responses/400_error.yaml
    '404':
--- a/docs/api/store/paths/customers.yaml
+++ b/docs/api/store/paths/customers.yaml
@@ -24,10 +24,7 @@ post:
      content:
        application/json:
          schema:
-            type: object
-            properties:
-              customer:
-                $ref: ../components/schemas/Customer.yaml
+            $ref: ../components/schemas/StoreCustomersRes.yaml
    '400':
      $ref: ../components/responses/400_error.yaml
    '404':
--- a/docs/api/store/paths/customers_me.yaml
+++ b/docs/api/store/paths/customers_me.yaml
@@ -24,10 +24,7 @@ get:
      content:
        application/json:
          schema:
-            type: object
-            properties:
-              customer:
-                $ref: ../components/schemas/Customer.yaml
+            $ref: ../components/schemas/StoreCustomersRes.yaml
    '400':
      $ref: ../components/responses/400_error.yaml
    '401':
@@ -69,10 +66,7 @@ post:
      content:
        application/json:
          schema:
-            type: object
-            properties:
-              customer:
-                $ref: ../components/schemas/Customer.yaml
+            $ref: ../components/schemas/StoreCustomersRes.yaml
    '400':
      $ref: ../components/responses/400_error.yaml
    '401':
--- a/docs/api/store/paths/customers_me_addresses.yaml
+++ b/docs/api/store/paths/customers_me_addresses.yaml
@@ -27,10 +27,7 @@ post:
      content:
        application/json:
          schema:
-            type: object
-            properties:
-              customer:
-                $ref: ../components/schemas/Customer.yaml
+            $ref: ../components/schemas/StoreCustomersRes.yaml
    '400':
      $ref: ../components/responses/400_error.yaml
    '401':
--- a/docs/api/store/paths/customers_me_addresses_{address_id}.yaml
+++ b/docs/api/store/paths/customers_me_addresses_{address_id}.yaml
@@ -31,10 +31,7 @@ delete:
      content:
        application/json:
          schema:
-            type: object
-            properties:
-              customer:
-                $ref: ../components/schemas/Customer.yaml
+            $ref: ../components/schemas/StoreCustomersRes.yaml
    '400':
      $ref: ../components/responses/400_error.yaml
    '401':
@@ -86,10 +83,7 @@ post:
      content:
        application/json:
          schema:
-            type: object
-            properties:
-              customer:
-                $ref: ../components/schemas/Customer.yaml
+            $ref: ../components/schemas/StoreCustomersRes.yaml
    '400':
      $ref: ../components/responses/400_error.yaml
    '401':
--- a/docs/api/store/paths/customers_me_orders.yaml
+++ b/docs/api/store/paths/customers_me_orders.yaml
@@ -187,21 +187,7 @@ get:
      content:
        application/json:
          schema:
-            type: object
-            properties:
-              orders:
-                type: array
-                items:
-                  $ref: ../components/schemas/Order.yaml
-              count:
-                type: integer
-                description: The total number of items available
-              offset:
-                type: integer
-                description: The number of items skipped before these items
-              limit:
-                type: integer
-                description: The number of items per page
+            $ref: ../components/schemas/StoreCustomersListOrdersRes.yaml
    '400':
      $ref: ../components/responses/400_error.yaml
    '401':
--- a/docs/api/store/paths/customers_me_payment-methods.yaml
+++ b/docs/api/store/paths/customers_me_payment-methods.yaml
@@ -25,22 +25,7 @@ get:
      content:
        application/json:
          schema:
-            type: object
-            properties:
-              payment_methods:
-                type: array
-                items:
-                  properties:
-                    provider_id:
-                      type: string
-                      description: >-
-                        The id of the Payment Provider where the payment method
-                        is saved.
-                    data:
-                      type: object
-                      description: >-
-                        The data needed for the Payment Provider to use the
-                        saved payment method.
+            $ref: ../components/schemas/StoreCustomersListPaymentMethodsRes.yaml
    '400':
      $ref: ../components/responses/400_error.yaml
    '401':
--- a/docs/api/store/paths/customers_password-reset.yaml
+++ b/docs/api/store/paths/customers_password-reset.yaml
@@ -26,10 +26,7 @@ post:
      content:
        application/json:
          schema:
-            type: object
-            properties:
-              customer:
-                $ref: ../components/schemas/Customer.yaml
+            $ref: ../components/schemas/StoreCustomersRes.yaml
    '400':
      $ref: ../components/responses/400_error.yaml
    '401':
--- a/docs/api/store/paths/gift-cards_{code}.yaml
+++ b/docs/api/store/paths/gift-cards_{code}.yaml
@@ -26,10 +26,7 @@ get:
      content:
        application/json:
          schema:
-            type: object
-            properties:
-              gift_card:
-                $ref: ../components/schemas/GiftCard.yaml
+            $ref: ../components/schemas/StoreGiftCardsRes.yaml
    '400':
      $ref: ../components/responses/400_error.yaml
    '404':
--- a/docs/api/store/paths/order-edits_{id}.yaml
+++ b/docs/api/store/paths/order-edits_{id}.yaml
@@ -26,10 +26,7 @@ get:
      content:
        application/json:
          schema:
-            type: object
-            properties:
-              order_edit:
-                $ref: ../components/schemas/OrderEdit.yaml
+            $ref: ../components/schemas/StoreOrderEditsRes.yaml
    '400':
      $ref: ../components/responses/400_error.yaml
    '401':
--- a/docs/api/store/paths/order-edits_{id}_complete.yaml
+++ b/docs/api/store/paths/order-edits_{id}_complete.yaml
@@ -26,10 +26,7 @@ post:
      content:
        application/json:
          schema:
-            type: object
-            properties:
-              order_edit:
-                $ref: ../components/schemas/OrderEdit.yaml
+            $ref: ../components/schemas/StoreOrderEditsRes.yaml
    '400':
      $ref: ../components/responses/400_error.yaml
    '401':
--- a/docs/api/store/paths/order-edits_{id}_decline.yaml
+++ b/docs/api/store/paths/order-edits_{id}_decline.yaml
@@ -31,10 +31,7 @@ post:
      content:
        application/json:
          schema:
-            type: object
-            properties:
-              order_edit:
-                $ref: ../components/schemas/OrderEdit.yaml
+            $ref: ../components/schemas/StoreOrderEditsRes.yaml
    '400':
      $ref: ../components/responses/400_error.yaml
    '401':
--- a/docs/api/store/paths/orders.yaml
+++ b/docs/api/store/paths/orders.yaml
@@ -46,10 +46,7 @@ get:
      content:
        application/json:
          schema:
-            type: object
-            properties:
-              order:
-                $ref: ../components/schemas/Order.yaml
+            $ref: ../components/schemas/StoreOrdersRes.yaml
    '400':
      $ref: ../components/responses/400_error.yaml
    '404':
--- a/docs/api/store/paths/orders_cart_{cart_id}.yaml
+++ b/docs/api/store/paths/orders_cart_{cart_id}.yaml
@@ -26,10 +26,7 @@ get:
      content:
        application/json:
          schema:
-            type: object
-            properties:
-              order:
-                $ref: ../components/schemas/Order.yaml
+            $ref: ../components/schemas/StoreOrdersRes.yaml
    '400':
      $ref: ../components/responses/400_error.yaml
    '404':
--- a/docs/api/store/paths/orders_{id}.yaml
+++ b/docs/api/store/paths/orders_{id}.yaml
@@ -26,10 +26,7 @@ get:
      content:
        application/json:
          schema:
-            type: object
-            properties:
-              order:
-                $ref: ../components/schemas/Order.yaml
+            $ref: ../components/schemas/StoreOrdersRes.yaml
    '400':
      $ref: ../components/responses/400_error.yaml
    '404':
--- a/docs/api/store/paths/payment-collections_{id}.yaml
+++ b/docs/api/store/paths/payment-collections_{id}.yaml
@@ -40,10 +40,7 @@ get:
      content:
        application/json:
          schema:
-            type: object
-            properties:
-              payment_collection:
-                $ref: ../components/schemas/PaymentCollection.yaml
+            $ref: ../components/schemas/StorePaymentCollectionsRes.yaml
    '400':
      $ref: ../components/responses/400_error.yaml
    '401':
--- a/docs/api/store/paths/payment-collections_{id}_sessions.yaml
+++ b/docs/api/store/paths/payment-collections_{id}_sessions.yaml
@@ -36,9 +36,7 @@ post:
      content:
        application/json:
          schema:
-            properties:
-              payment_collection:
-                $ref: ../components/schemas/PaymentCollection.yaml
+            $ref: ../components/schemas/StorePaymentCollectionsRes.yaml
    '400':
      $ref: ../components/responses/400_error.yaml
    '401':
--- a/docs/api/store/paths/payment-collections_{id}_sessions_batch.yaml
+++ b/docs/api/store/paths/payment-collections_{id}_sessions_batch.yaml
@@ -38,9 +38,7 @@ post:
      content:
        application/json:
          schema:
-            properties:
-              payment_collection:
-                $ref: ../components/schemas/PaymentCollection.yaml
+            $ref: ../components/schemas/StorePaymentCollectionsRes.yaml
    '400':
      $ref: ../components/responses/400_error.yaml
    '401':
--- a/docs/api/store/paths/payment-collections_{id}_sessions_batch_authorize.yaml
+++ b/docs/api/store/paths/payment-collections_{id}_sessions_batch_authorize.yaml
@@ -38,9 +38,7 @@ post:
      content:
        application/json:
          schema:
-            properties:
-              payment_collection:
-                $ref: ../components/schemas/PaymentCollection.yaml
+            $ref: ../components/schemas/StorePaymentCollectionsRes.yaml
    '400':
      $ref: ../components/responses/400_error.yaml
    '401':
--- a/docs/api/store/paths/payment-collections_{id}_sessions_{session_id}.yaml
+++ b/docs/api/store/paths/payment-collections_{id}_sessions_{session_id}.yaml
@@ -37,10 +37,7 @@ post:
      content:
        application/json:
          schema:
-            type: object
-            properties:
-              payment_session:
-                $ref: ../components/schemas/PaymentSession.yaml
+            $ref: ../components/schemas/StorePaymentCollectionsSessionRes.yaml
    '400':
      $ref: ../components/responses/400_error.yaml
    '404':
--- a/docs/api/store/paths/payment-collections_{id}_sessions_{session_id}_authorize.yaml
+++ b/docs/api/store/paths/payment-collections_{id}_sessions_{session_id}_authorize.yaml
@@ -38,9 +38,7 @@ post:
      content:
        application/json:
          schema:
-            properties:
-              payment_session:
-                $ref: ../components/schemas/PaymentSession.yaml
+            $ref: ../components/schemas/StorePaymentCollectionsSessionRes.yaml
    '400':
      $ref: ../components/responses/400_error.yaml
    '401':
--- a/docs/api/store/paths/product-categories.yaml
+++ b/docs/api/store/paths/product-categories.yaml
@@ -0,0 +1,71 @@
+get:
+  operationId: GetProductCategories
+  summary: List Product Categories
+  description: Retrieve a list of product categories.
+  x-authenticated: false
+  parameters:
+    - in: query
+      name: q
+      description: Query used for searching product category names orhandles.
+      schema:
+        type: string
+    - in: query
+      name: parent_category_id
+      description: Returns categories scoped by parent
+      schema:
+        type: string
+    - in: query
+      name: offset
+      description: How many product categories to skip in the result.
+      schema:
+        type: integer
+        default: 0
+    - in: query
+      name: limit
+      description: Limit the number of product categories returned.
+      schema:
+        type: integer
+        default: 100
+  x-codeSamples:
+    - lang: Shell
+      label: cURL
+      source:
+        $ref: ../code_samples/Shell/product-categories/getundefined
+  security:
+    - api_token: []
+    - cookie_auth: []
+  tags:
+    - Product Category
+  responses:
+    '200':
+      description: OK
+      content:
+        application/json:
+          schema:
+            type: object
+            properties:
+              product_categories:
+                type: array
+                items:
+                  $ref: ../components/schemas/ProductCategory.yaml
+              count:
+                type: integer
+                description: The total number of items available
+              offset:
+                type: integer
+                description: The number of items skipped before these items
+              limit:
+                type: integer
+                description: The number of items per page
+    '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
--- a/docs/api/store/paths/product-categories_{id}.yaml
+++ b/docs/api/store/paths/product-categories_{id}.yaml
@@ -0,0 +1,59 @@
+get:
+  operationId: GetProductCategoriesCategory
+  summary: Get a Product Category
+  description: Retrieves a Product Category.
+  x-authenticated: false
+  parameters:
+    - in: path
+      name: id
+      required: true
+      description: The ID of the Product Category
+      schema:
+        type: string
+    - in: query
+      name: expand
+      description: >-
+        (Comma separated) Which fields should be expanded in each product
+        category.
+      schema:
+        type: string
+    - in: query
+      name: fields
+      description: >-
+        (Comma separated) Which fields should be retrieved in each product
+        category.
+      schema:
+        type: string
+  x-codeSamples:
+    - lang: JavaScript
+      label: JS Client
+      source:
+        $ref: ../code_samples/JavaScript/product-categories_{id}/getundefined
+    - lang: Shell
+      label: cURL
+      source:
+        $ref: ../code_samples/Shell/product-categories_{id}/getundefined
+  security:
+    - api_token: []
+    - cookie_auth: []
+  tags:
+    - Product Category
+  responses:
+    '200':
+      description: OK
+      content:
+        application/json:
+          schema:
+            $ref: ../components/schemas/StoreGetProductCategoryRes.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
--- a/docs/api/store/paths/product-tags.yaml
+++ b/docs/api/store/paths/product-tags.yaml
@@ -0,0 +1,137 @@
+get:
+  operationId: GetProductTags
+  summary: List Product Tags
+  description: Retrieve a list of Product Tags.
+  x-authenticated: true
+  parameters:
+    - in: query
+      name: limit
+      description: The number of types to return.
+      schema:
+        type: integer
+        default: 20
+    - in: query
+      name: offset
+      description: The number of items to skip before the results.
+      schema:
+        type: integer
+        default: 0
+    - in: query
+      name: order
+      description: The field to sort items by.
+      schema:
+        type: string
+    - in: query
+      name: discount_condition_id
+      description: The discount condition id on which to filter the product tags.
+      schema:
+        type: string
+    - in: query
+      name: value
+      style: form
+      explode: false
+      description: The tag values to search for
+      schema:
+        type: array
+        items:
+          type: string
+    - in: query
+      name: id
+      style: form
+      explode: false
+      description: The tag IDs to search for
+      schema:
+        type: array
+        items:
+          type: string
+    - in: query
+      name: q
+      description: A query string to search values for
+      schema:
+        type: string
+    - in: query
+      name: created_at
+      description: Date comparison for when resulting product tags were created.
+      schema:
+        type: object
+        properties:
+          lt:
+            type: string
+            description: filter by dates less than this date
+            format: date
+          gt:
+            type: string
+            description: filter by dates greater than this date
+            format: date
+          lte:
+            type: string
+            description: filter by dates less than or equal to this date
+            format: date
+          gte:
+            type: string
+            description: filter by dates greater than or equal to this date
+            format: date
+    - in: query
+      name: updated_at
+      description: Date comparison for when resulting product tags were updated.
+      schema:
+        type: object
+        properties:
+          lt:
+            type: string
+            description: filter by dates less than this date
+            format: date
+          gt:
+            type: string
+            description: filter by dates greater than this date
+            format: date
+          lte:
+            type: string
+            description: filter by dates less than or equal to this date
+            format: date
+          gte:
+            type: string
+            description: filter by dates greater than or equal to this date
+            format: date
+  x-codeSamples:
+    - lang: JavaScript
+      label: JS Client
+      source:
+        $ref: ../code_samples/JavaScript/product-tags/getundefined
+    - lang: Shell
+      label: cURL
+      source:
+        $ref: ../code_samples/Shell/product-tags/getundefined
+  tags:
+    - Product Tag
+  responses:
+    '200':
+      description: OK
+      content:
+        application/json:
+          schema:
+            type: object
+            properties:
+              product_tags:
+                $ref: ../components/schemas/ProductTag.yaml
+              count:
+                type: integer
+                description: The total number of items available
+              offset:
+                type: integer
+                description: The number of items skipped before these items
+              limit:
+                type: integer
+                description: The number of items per page
+    '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
--- a/docs/api/store/paths/product-types.yaml
+++ b/docs/api/store/paths/product-types.yaml
@@ -113,19 +113,7 @@ get:
      content:
        application/json:
          schema:
-            type: object
-            properties:
-              product_types:
-                $ref: ../components/schemas/ProductType.yaml
-              count:
-                type: integer
-                description: The total number of items available
-              offset:
-                type: integer
-                description: The number of items skipped before these items
-              limit:
-                type: integer
-                description: The number of items per page
+            $ref: ../components/schemas/StoreProductTypesListRes.yaml
    '400':
      $ref: ../components/responses/400_error.yaml
    '401':
--- a/docs/api/store/paths/products.yaml
+++ b/docs/api/store/paths/products.yaml
@@ -169,31 +169,7 @@ get:
      content:
        application/json:
          schema:
-            type: object
-            properties:
-              products:
-                type: array
-                items:
-                  allOf:
-                    - $ref: ../components/schemas/Product.yaml
-                    - type: object
-                      properties:
-                        variants:
-                          type: array
-                          items:
-                            allOf:
-                              - $ref: ../components/schemas/ProductVariant.yaml
-                              - $ref: >-
-                                  ../components/schemas/ProductVariantPricesFields.yaml
-              count:
-                type: integer
-                description: The total number of items available
-              offset:
-                type: integer
-                description: The number of items skipped before these items
-              limit:
-                type: integer
-                description: The number of items per page
+            $ref: ../components/schemas/StoreProductsListRes.yaml
    '400':
      $ref: ../components/responses/400_error.yaml
    '404':
--- a/docs/api/store/paths/products_search.yaml
+++ b/docs/api/store/paths/products_search.yaml
@@ -36,13 +36,7 @@ post:
      content:
        application/json:
          schema:
-            type: object
-            properties:
-              hits:
-                type: array
-                description: >-
-                  Array of results. The format of the items depends on the
-                  search engine installed on the server.
+            $ref: ../components/schemas/StorePostSearchRes.yaml
    '400':
      $ref: ../components/responses/400_error.yaml
    '404':
--- a/docs/api/store/paths/products_{id}.yaml
+++ b/docs/api/store/paths/products_{id}.yaml
@@ -50,20 +50,7 @@ get:
      content:
        application/json:
          schema:
-            type: object
-            properties:
-              product:
-                allOf:
-                  - $ref: ../components/schemas/Product.yaml
-                  - type: object
-                    properties:
-                      variants:
-                        type: array
-                        items:
-                          allOf:
-                            - $ref: ../components/schemas/ProductVariant.yaml
-                            - $ref: >-
-                                ../components/schemas/ProductVariantPricesFields.yaml
+            $ref: ../components/schemas/StoreProductsRes.yaml
    '400':
      $ref: ../components/responses/400_error.yaml
    '404':
--- a/docs/api/store/paths/regions.yaml
+++ b/docs/api/store/paths/regions.yaml
@@ -76,12 +76,7 @@ get:
      content:
        application/json:
          schema:
-            type: object
-            properties:
-              regions:
-                type: array
-                items:
-                  $ref: ../components/schemas/Region.yaml
+            $ref: ../components/schemas/StoreRegionsListRes.yaml
    '400':
      $ref: ../components/responses/400_error.yaml
    '404':
--- a/docs/api/store/paths/regions_{id}.yaml
+++ b/docs/api/store/paths/regions_{id}.yaml
@@ -26,10 +26,7 @@ get:
      content:
        application/json:
          schema:
-            type: object
-            properties:
-              region:
-                $ref: ../components/schemas/Region.yaml
+            $ref: ../components/schemas/StoreRegionsRes.yaml
    '400':
      $ref: ../components/responses/400_error.yaml
    '404':
--- a/docs/api/store/paths/return-reasons.yaml
+++ b/docs/api/store/paths/return-reasons.yaml
@@ -19,12 +19,7 @@ get:
      content:
        application/json:
          schema:
-            type: object
-            properties:
-              return_reasons:
-                type: array
-                items:
-                  $ref: ../components/schemas/ReturnReason.yaml
+            $ref: ../components/schemas/StoreReturnReasonsListRes.yaml
    '400':
      $ref: ../components/responses/400_error.yaml
    '404':
--- a/docs/api/store/paths/return-reasons_{id}.yaml
+++ b/docs/api/store/paths/return-reasons_{id}.yaml
@@ -26,10 +26,7 @@ get:
      content:
        application/json:
          schema:
-            type: object
-            properties:
-              return_reason:
-                $ref: ../components/schemas/ReturnReason.yaml
+            $ref: ../components/schemas/StoreReturnReasonsRes.yaml
    '400':
      $ref: ../components/responses/400_error.yaml
    '404':
--- a/docs/api/store/paths/returns.yaml
+++ b/docs/api/store/paths/returns.yaml
@@ -24,10 +24,7 @@ post:
      content:
        application/json:
          schema:
-            type: object
-            properties:
-              return:
-                $ref: ../components/schemas/Return.yaml
+            $ref: ../components/schemas/StoreReturnsRes.yaml
    '400':
      $ref: ../components/responses/400_error.yaml
    '404':
--- a/docs/api/store/paths/shipping-options.yaml
+++ b/docs/api/store/paths/shipping-options.yaml
@@ -37,12 +37,7 @@ get:
      content:
        application/json:
          schema:
-            type: object
-            properties:
-              shipping_options:
-                type: array
-                items:
-                  $ref: ../components/schemas/ShippingOption.yaml
+            $ref: ../components/schemas/StoreShippingOptionsListRes.yaml
    '400':
      $ref: ../components/responses/400_error.yaml
    '404':
--- a/docs/api/store/paths/shipping-options_{cart_id}.yaml
+++ b/docs/api/store/paths/shipping-options_{cart_id}.yaml
@@ -26,12 +26,7 @@ get:
      content:
        application/json:
          schema:
-            type: object
-            properties:
-              shipping_options:
-                type: array
-                items:
-                  $ref: ../components/schemas/ShippingOption.yaml
+            $ref: ../components/schemas/StoreShippingOptionsListRes.yaml
    '400':
      $ref: ../components/responses/400_error.yaml
    '404':
--- a/docs/api/store/paths/swaps.yaml
+++ b/docs/api/store/paths/swaps.yaml
@@ -26,10 +26,7 @@ post:
      content:
        application/json:
          schema:
-            type: object
-            properties:
-              swap:
-                $ref: ../components/schemas/Swap.yaml
+            $ref: ../components/schemas/StoreSwapsRes.yaml
    '400':
      $ref: ../components/responses/400_error.yaml
    '404':
--- a/docs/api/store/paths/swaps_{cart_id}.yaml
+++ b/docs/api/store/paths/swaps_{cart_id}.yaml
@@ -26,10 +26,7 @@ get:
      content:
        application/json:
          schema:
-            type: object
-            properties:
-              swap:
-                $ref: ../components/schemas/Swap.yaml
+            $ref: ../components/schemas/StoreSwapsRes.yaml
    '400':
      $ref: ../components/responses/400_error.yaml
    '404':
--- a/docs/api/store/paths/variants.yaml
+++ b/docs/api/store/paths/variants.yaml
@@ -75,14 +75,7 @@ get:
      content:
        application/json:
          schema:
-            type: object
-            properties:
-              variants:
-                type: array
-                items:
-                  allOf:
-                    - $ref: ../components/schemas/ProductVariant.yaml
-                    - $ref: ../components/schemas/ProductVariantPricesFields.yaml
+            $ref: ../components/schemas/StoreVariantsListRes.yaml
    '400':
      $ref: ../components/responses/400_error.yaml
    '404':
--- a/docs/api/store/paths/variants_{variant_id}.yaml
+++ b/docs/api/store/paths/variants_{variant_id}.yaml
@@ -42,12 +42,7 @@ get:
      content:
        application/json:
          schema:
-            type: object
-            properties:
-              variant:
-                allOf:
-                  - $ref: ../components/schemas/ProductVariant.yaml
-                  - $ref: ../components/schemas/ProductVariantPricesFields.yaml
+            $ref: ../components/schemas/StoreVariantsRes.yaml
    '400':
      $ref: ../components/responses/400_error.yaml
    '404':