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

Co-authored-by: shahednasser <shahednasser@users.noreply.github.com>

docs/api/admin/components/schemas/shipping_method.yaml

@@ -59,7 +59,7 @@ properties:
     type: array
     description: Available if the relation `tax_lines` is expanded.
     items:
-      $ref: ./tax_line.yaml
+      $ref: ./shipping_method_tax_line.yaml
   price:
     description: >-
       The amount to charge for the Shipping Method. The currency of the price is

docs/api/admin/components/schemas/shipping_method_tax_line.yaml

@@ -1,6 +1,6 @@
-title: Sales Channel
-description: A Sales Channel
-x-resourceId: sales_channel_tax_line
+title: Shipping Method Tax Line
+description: Shipping Method Tax Line
+x-resourceId: shipping_method_tax_line
 required:
   - shipping_method_id
   - rate

docs/api/admin/paths/discounts_{discount_id}_conditions.yaml

@@ -1,6 +1,7 @@
 post:
   operationId: PostDiscountsDiscountConditions
-  summary: >-
+  summary: Create a DiscountCondition
+  description: >-
     Creates a DiscountCondition. Only one of `products`, `product_types`,
     `product_collections`, `product_tags`, and `customer_groups` should be
     provided.
@@ -26,7 +27,6 @@ post:
         result.
       schema:
         type: string
-  description: Creates a DiscountCondition
   requestBody:
     content:
       application/json:

docs/api/admin/paths/discounts_{discount_id}_conditions_{condition_id}.yaml

@@ -92,7 +92,8 @@ get:
                 $ref: ../components/schemas/discount_condition.yaml
 post:
   operationId: PostDiscountsDiscountConditionsCondition
-  summary: >-
+  summary: Update a DiscountCondition
+  description: >-
     Updates a DiscountCondition. Only one of `products`, `product_types`,
     `product_collections`, `product_tags`, and `customer_groups` should be
     provided.
@@ -124,7 +125,6 @@ post:
         result.
       schema:
         type: string
-  description: Updates a DiscountCondition
   requestBody:
     content:
       application/json:

docs/api/admin/paths/gift-cards_{id}.yaml

@@ -55,9 +55,9 @@ get:
                 $ref: ../components/schemas/gift_card.yaml
 post:
   operationId: PostGiftCardsGiftCard
-  summary: Create a Gift Card
+  summary: Update a Gift Card
   description: >-
-    Creates a Gift Card that can redeemed by its unique code. The Gift Card is
+    Update a Gift Card that can redeemed by its unique code. The Gift Card is
     only valid within 1 region.
   x-authenticated: true
   parameters: