TASK: Updating RAML types, Postman and OAS definition

Author: ct-sdks[bot]

bruno/api/Project/In-store/Shipping-methods/Matching-cart/ByProjectKeyInStoreKeyByStoreKeyShippingMethodsMatchingCartGet.bru

@@ -1,5 +1,5 @@
 meta {
-  name: Get matching ShippingMethods for a Cart in Store
+  name: Get matching ShippingMethods for a Cart in a Store
   type: http
   seq: 740
 }

bruno/api/Project/Shipping-methods/Matching-cart-location/ByProjectKeyShippingMethodsMatchingCartLocationGet.bru

@@ -1,5 +1,5 @@
 meta {
-  name: Get ShippingMethods for a Cart and Location
+  name: Get matching ShippingMethods for a Cart and Location
   type: http
   seq: 452
 }

bruno/api/Project/Shipping-methods/Matching-cart/ByProjectKeyShippingMethodsMatchingCartGet.bru

@@ -1,5 +1,5 @@
 meta {
-  name: Get ShippingMethods for a Cart
+  name: Get matching ShippingMethods for a Cart
   type: http
   seq: 450
 }

bruno/api/Project/Shipping-methods/Matching-location/ByProjectKeyShippingMethodsMatchingLocationGet.bru

@@ -1,5 +1,5 @@
 meta {
-  name: Get ShippingMethods for a Location
+  name: Get matching ShippingMethods for a Location
   type: http
   seq: 456
 }

bruno/api/Project/Shipping-methods/Matching-orderedit/ByProjectKeyShippingMethodsMatchingOrdereditGet.bru

@@ -1,5 +1,5 @@
 meta {
-  name: Get ShippingMethods for an Order Edit
+  name: Get matching ShippingMethods for an OrderEdit
   type: http
   seq: 454
 }

oas/api/openapi.yaml

@@ -19556,7 +19556,7 @@ paths:
           $ref: '#/components/responses/errorable_503'
   /{projectKey}/in-store/key={storeKey}/shipping-methods/matching-cart:
     description: |-
-      Get ShippingMethods for a cart in a store
+      Get matching ShippingMethods for a Cart in a Store
     parameters:
       - name: projectKey
         in: path
@@ -19579,9 +19579,10 @@ paths:
             - "manage_my_orders:{projectKey}:{storeKey}"
       operationId: ByProjectKeyInStoreKeyByStoreKeyShippingMethodsMatchingCartGet
       description: |-
-        Retrieves the active ShippingMethods that can ship to the shipping address of the given Cart in a given [Store](ctp:api:type:Store).
-        Each ShippingMethod contains exactly one ShippingRate with the flag `isMatching` set to `true`.
-        This ShippingRate is used when the ShippingMethod is [added to the Cart](ctp:api:type:CartSetShippingMethodAction).
+        Retrieves the active ShippingMethods that can ship to the shipping address of the provided Cart in a [Store](ctp:api:type:Store).
+
+        Each ShippingMethod contains exactly one ShippingRate with the flag `isMatching` set to `true`. This ShippingRate is used when the ShippingMethod is [added to the Cart](ctp:api:type:CartSetShippingMethodAction).
+
         If a matching ShippingMethod has `isDefault` set to `true`, it is returned as the first item in the array.
       parameters:
         - name: cartId
@@ -19634,7 +19635,7 @@ paths:
             - "manage_my_orders:{projectKey}:{storeKey}"
       operationId: ByProjectKeyInStoreKeyByStoreKeyShippingMethodsMatchingCartHead
       description: |-
-        Checks if an active ShippingMethod that can ship to the shipping address of the given Cart exists in the given [Store](ctp:api:type:Store). Returns a `200` status if the ShippingMethod exists, or a `404` status otherwise.
+        Checks if an active ShippingMethod that can ship to the shipping address of the provided Cart exists in a [Store](ctp:api:type:Store). Returns a `200 OK` status if the ShippingMethod exists or a [Not Found](/../api/errors#404-not-found) error otherwise.
       parameters:
         - name: cartId
           in: query
@@ -34600,6 +34601,8 @@ paths:
             - "view_shipping_methods:{projectKey}"
             - "manage_my_orders:{projectKey}"
       operationId: ByProjectKeyShippingMethodsGet
+      description: |-
+        Retrieves all ShippingMethods in the Project.
       parameters:
         - name: expand
           in: query
@@ -34694,7 +34697,7 @@ paths:
             - "manage_my_orders:{projectKey}"
       operationId: ByProjectKeyShippingMethodsHead
       description: |-
-        Checks if one or more ShippingMethods exist for the provided query predicate. Returns a `200` status if any ShippingMethods match the query predicate, or a `404` status otherwise.
+        Checks if one or more ShippingMethods exist for the provided query predicate. Returns a `200 OK` status if any ShippingMethods match the query predicate or a [Not Found](/../api/errors#404-not-found) error otherwise.
       parameters:
         - name: where
           in: query
@@ -34730,6 +34733,8 @@ paths:
             - "manage_orders:{projectKey}"
             - "manage_shipping_methods:{projectKey}"
       operationId: ByProjectKeyShippingMethodsPost
+      description: |-
+        Creates a ShippingMethod in the Project.
       parameters:
         - name: expand
           in: query
@@ -34788,6 +34793,8 @@ paths:
             - "view_shipping_methods:{projectKey}"
             - "manage_my_orders:{projectKey}"
       operationId: ByProjectKeyShippingMethodsKeyByKeyGet
+      description: |-
+        Retrieves a ShippingMethod with the provided `key`.
       parameters:
         - name: expand
           in: query
@@ -34829,7 +34836,7 @@ paths:
             - "manage_my_orders:{projectKey}"
       operationId: ByProjectKeyShippingMethodsKeyByKeyHead
       description: |-
-        Checks if a ShippingMethod exists with the provided `key`. Returns a `200` status if the ShippingMethod exists, or a `404` status otherwise.
+        Checks if a ShippingMethod exists with the provided `key`. Returns a `200 OK` status if the ShippingMethod exists or a [Not Found](/../api/errors#404-not-found) error otherwise.
       responses:
         "200":
           description: |-
@@ -34855,6 +34862,8 @@ paths:
             - "manage_orders:{projectKey}"
             - "manage_shipping_methods:{projectKey}"
       operationId: ByProjectKeyShippingMethodsKeyByKeyPost
+      description: |-
+        Updates a ShippingMethod in the Project using one or more [update actions](/../api/projects/shippingMethods#update-actions).
       parameters:
         - name: expand
           in: query
@@ -34902,6 +34911,8 @@ paths:
             - "manage_orders:{projectKey}"
             - "manage_shipping_methods:{projectKey}"
       operationId: ByProjectKeyShippingMethodsKeyByKeyDelete
+      description: |-
+        Deletes a ShippingMethod in the Project.
       parameters:
         - name: version
           in: query
@@ -34947,7 +34958,7 @@ paths:
           $ref: '#/components/responses/errorable_503'
   /{projectKey}/shipping-methods/matching-cart:
     description: |-
-      Get ShippingMethods for a Cart
+      Get matching ShippingMethods for a Cart
     parameters:
       - name: projectKey
         in: path
@@ -34962,9 +34973,10 @@ paths:
             - "manage_my_orders:{projectKey}"
       operationId: ByProjectKeyShippingMethodsMatchingCartGet
       description: |-
-        Retrieves the active ShippingMethods that can ship to the shipping address of the given Cart.
-        Each ShippingMethod contains exactly one ShippingRate with the flag `isMatching` set to `true`.
-        This ShippingRate is used when the ShippingMethod is [added to the Cart](ctp:api:type:CartSetShippingMethodAction).
+        Retrieves the active ShippingMethods that can ship to the shipping address of the provided Cart.
+
+        Each ShippingMethod contains exactly one ShippingRate with the flag `isMatching` set to `true`. This ShippingRate is used when the ShippingMethod is [added to the Cart](ctp:api:type:CartSetShippingMethodAction).
+
         If a matching ShippingMethod has `isDefault` set to `true`, it is returned as the first item in the array.
       parameters:
         - name: cartId
@@ -35014,7 +35026,7 @@ paths:
             - "manage_my_orders:{projectKey}"
       operationId: ByProjectKeyShippingMethodsMatchingCartHead
       description: |-
-        Checks if an active ShippingMethod exists for the given Cart. If a matching ShippingMethod has `isDefault` set to `true`, it is returned as the first item in the array. Returns a `200` status if the ShippingMethod exists, or a `404` status otherwise.
+        Checks if an active ShippingMethod exists for the provided Cart. Returns a `200 OK` status if the ShippingMethod exists or a [Not Found](/../api/errors#404-not-found) error otherwise.
       parameters:
         - name: cartId
           in: query
@@ -35044,7 +35056,7 @@ paths:
           content: {}
   /{projectKey}/shipping-methods/matching-cart-location:
     description: |-
-      Get ShippingMethods for a Cart and Location
+      Get matching ShippingMethods for a Cart and Location
     parameters:
       - name: projectKey
         in: path
@@ -35059,10 +35071,11 @@ paths:
             - "manage_my_orders:{projectKey}"
       operationId: ByProjectKeyShippingMethodsMatchingCartLocationGet
       description: |-
-        Retrieves the active ShippingMethods that can ship to the given [Location](ctp:api:type:Location)
-        with a `predicate` that matches the given Cart.
-        Each ShippingMethod contains exactly one ShippingRate with the flag `isMatching` set to `true`.
-        This ShippingRate is used when the ShippingMethod is [added to the Cart](ctp:api:type:CartSetShippingMethodAction).
+        Retrieves the active ShippingMethods that can ship to the provided [Location](ctp:api:type:Location)
+        with a `predicate` that matches the provided Cart.
+
+        Each ShippingMethod contains exactly one ShippingRate with the flag `isMatching` set to `true`. This ShippingRate is used when the ShippingMethod is [added to the Cart](ctp:api:type:CartSetShippingMethodAction).
+
         If a matching ShippingMethod has `isDefault` set to `true`, it is returned as the first item in the array.
       parameters:
         - name: country
@@ -35126,7 +35139,7 @@ paths:
             - "manage_my_orders:{projectKey}"
       operationId: ByProjectKeyShippingMethodsMatchingCartLocationHead
       description: |-
-        Checks if an active ShippingMethod that can ship to the given [Location](ctp:api:type:Location) exists for the given Cart. Returns a `200` status if the ShippingMethod exists, or a `404` status otherwise.
+        Checks if an active ShippingMethod that can ship to the provided [Location](ctp:api:type:Location) exists for the provided Cart. Returns a `200 OK` status if the ShippingMethod exists or a [Not Found](/../api/errors#404-not-found) error otherwise.
       parameters:
         - name: country
           in: query
@@ -35170,7 +35183,7 @@ paths:
           content: {}
   /{projectKey}/shipping-methods/matching-location:
     description: |-
-      Get ShippingMethods for a Location
+      Get matching ShippingMethods for a Location
     parameters:
       - name: projectKey
         in: path
@@ -35185,12 +35198,15 @@ paths:
             - "manage_my_orders:{projectKey}"
       operationId: ByProjectKeyShippingMethodsMatchingLocationGet
       description: |-
-        Retrieves the active ShippingMethods that can ship to the given [Location](/projects/zones#location).
-        ShippingMethods that have a `predicate` defined are automatically disqualified.
-        If the `currency` parameter is given, then the ShippingMethods must also have a rate defined in the specified currency.
-        Each ShippingMethod contains at least one ShippingRate with the flag `isMatching` set to `true`.
-        If the `currency` parameter is given, exactly one ShippingRate will contain it.
-        If a matching ShippingMethod has `isDefault` set to `true`, it is returned as the first item in the array.
+        Retrieves the active ShippingMethods that can ship to the provided [Location](/projects/zones#location).
+
+        The following applies:
+
+        - ShippingMethods that have a `predicate` defined are automatically disqualified.
+        - If the `currency` parameter is provided, then the ShippingMethods must also have a rate defined in the specified currency.
+        - Each ShippingMethod contains at least one ShippingRate with the flag `isMatching` set to `true`.
+        - If the `currency` parameter is provided, exactly one ShippingRate will contain it.
+        - If a matching ShippingMethod has `isDefault` set to `true`, it is returned as the first item in the array.
       parameters:
         - name: country
           in: query
@@ -35262,7 +35278,7 @@ paths:
             - "manage_my_orders:{projectKey}"
       operationId: ByProjectKeyShippingMethodsMatchingLocationHead
       description: |-
-        Checks if an active ShippingMethod that can ship to the given [Location](ctp:api:type:Location) exists. Returns a `200` status if the ShippingMethod exists, or a `404` status otherwise.
+        Checks if an active ShippingMethod that can ship to the provided [Location](ctp:api:type:Location) exists. Returns a `200 OK` status if the ShippingMethod exists or a [Not Found](/../api/errors#404-not-found) error otherwise.
       parameters:
         - name: country
           in: query
@@ -35306,7 +35322,7 @@ paths:
           content: {}
   /{projectKey}/shipping-methods/matching-orderedit:
     description: |-
-      Get ShippingMethods for an Order Edit
+      Get matching ShippingMethods for an OrderEdit
     parameters:
       - name: projectKey
         in: path
@@ -35320,8 +35336,10 @@ paths:
             - "view_shipping_methods:{projectKey}"
       operationId: ByProjectKeyShippingMethodsMatchingOrdereditGet
       description: |-
-        Retrieves the active ShippingMethods that can ship to the given [Location](ctp:api:type:Location) for an [OrderEdit](ctp:api:type:OrderEdit).
+        Retrieves the active ShippingMethods that can ship to the provided [Location](ctp:api:type:Location) for an [OrderEdit](ctp:api:type:OrderEdit).
+
         If a matching ShippingMethod has `isDefault` set to `true`, it is returned as the first item in the array.
+
         If the OrderEdit preview cannot be generated, an [EditPreviewFailed](ctp:api:type:EditPreviewFailedError) error is returned.
       parameters:
         - name: orderEditId
@@ -35375,7 +35393,7 @@ paths:
             - "view_shipping_methods:{projectKey}"
       operationId: ByProjectKeyShippingMethodsMatchingOrdereditHead
       description: |-
-        Checks if an active ShippingMethod that can ship to the given [Location](ctp:api:type:Location) exists for the given [OrderEdit](ctp:api:type:OrderEdit). Returns a `200` status if the ShippingMethod exists, or a `404` status otherwise.
+        Checks if an active ShippingMethod that can ship to the provided [Location](ctp:api:type:Location) exists for the provided [OrderEdit](ctp:api:type:OrderEdit). Returns a `200 OK` status if the ShippingMethod exists or a [Not Found](/../api/errors#404-not-found) error otherwise.
       parameters:
         - name: orderEditId
           in: query
@@ -35436,6 +35454,8 @@ paths:
             - "view_shipping_methods:{projectKey}"
             - "manage_my_orders:{projectKey}"
       operationId: ByProjectKeyShippingMethodsByIDGet
+      description: |-
+        Retrieves a ShippingMethod with the provided `id`.
       parameters:
         - name: expand
           in: query
@@ -35477,7 +35497,7 @@ paths:
             - "manage_my_orders:{projectKey}"
       operationId: ByProjectKeyShippingMethodsByIDHead
       description: |-
-        Checks if a ShippingMethod exists with the provided `id`. Returns a `200` status if the ShippingMethod exists, or a `404` status otherwise.
+        Checks if a ShippingMethod exists with the provided `id`. Returns a `200 OK` status if the ShippingMethod exists or a [Not Found](/../api/errors#404-not-found) error otherwise.
       responses:
         "200":
           description: |-
@@ -35503,6 +35523,8 @@ paths:
             - "manage_orders:{projectKey}"
             - "manage_shipping_methods:{projectKey}"
       operationId: ByProjectKeyShippingMethodsByIDPost
+      description: |-
+        Updates a ShippingMethod in the Project using one or more [update actions](/../api/projects/shippingMethods#update-actions).
       parameters:
         - name: expand
           in: query
@@ -35550,6 +35572,8 @@ paths:
             - "manage_orders:{projectKey}"
             - "manage_shipping_methods:{projectKey}"
       operationId: ByProjectKeyShippingMethodsByIDDelete
+      description: |-
+        Deletes a ShippingMethod in the Project.
       parameters:
         - name: version
           in: query
@@ -39791,6 +39815,8 @@ paths:
         - oauth_2_0:
             - "view_orders:{projectKey}"
       operationId: ByProjectKeyZonesGet
+      description: |-
+        Retrieves all Zones in the Project.
       parameters:
         - name: expand
           in: query
@@ -39883,7 +39909,7 @@ paths:
             - "view_orders:{projectKey}"
       operationId: ByProjectKeyZonesHead
       description: |-
-        Checks if one or more Zones exist for the provided query predicate. Returns a `200` status if any Zones match the query predicate, or a `404` status otherwise.
+        Checks if one or more Zones exist for the provided query predicate. Returns a `200 OK` status if any Zones match the query predicate, or a [Not Found](/../api/errors#404-not-found) error otherwise.
       parameters:
         - name: where
           in: query
@@ -39918,6 +39944,8 @@ paths:
         - oauth_2_0:
             - "manage_orders:{projectKey}"
       operationId: ByProjectKeyZonesPost
+      description: |-
+        Creates a Zone in the Project.
       parameters:
         - name: expand
           in: query
@@ -39974,6 +40002,8 @@ paths:
         - oauth_2_0:
             - "view_orders:{projectKey}"
       operationId: ByProjectKeyZonesKeyByKeyGet
+      description: |-
+        Retrieves a Zone with the provided `key`.
       parameters:
         - name: expand
           in: query
@@ -40013,7 +40043,7 @@ paths:
             - "view_orders:{projectKey}"
       operationId: ByProjectKeyZonesKeyByKeyHead
       description: |-
-        Checks if a Zone exists with the provided `key`. Returns a `200` status if the Zone exists, or a `404` status otherwise.
+        Checks if a Zone exists with the provided `key`. Returns a `200 OK` status if the Zone exists or a [Not Found](/../api/errors#404-not-found) error otherwise.
       responses:
         "200":
           description: |-
@@ -40038,6 +40068,8 @@ paths:
         - oauth_2_0:
             - "manage_orders:{projectKey}"
       operationId: ByProjectKeyZonesKeyByKeyPost
+      description: |-
+        Updates a Zone in the Project using one or more [update actions](/../api/projects/zones#update-actions).
       parameters:
         - name: expand
           in: query
@@ -40084,6 +40116,8 @@ paths:
         - oauth_2_0:
             - "manage_orders:{projectKey}"
       operationId: ByProjectKeyZonesKeyByKeyDelete
+      description: |-
+        Deletes a Zone in the Project.
       parameters:
         - name: version
           in: query
@@ -40144,6 +40178,8 @@ paths:
         - oauth_2_0:
             - "view_orders:{projectKey}"
       operationId: ByProjectKeyZonesByIDGet
+      description: |-
+        Retrieves a Zone with the provided `id`.
       parameters:
         - name: expand
           in: query
@@ -40183,7 +40219,7 @@ paths:
             - "view_orders:{projectKey}"
       operationId: ByProjectKeyZonesByIDHead
       description: |-
-        Checks if a Zone exists with the provided `id`. Returns a `200` status if the Zone exists, or a `404` status otherwise.
+        Checks if a Zone exists with the provided `id`. Returns a `200 OK` status if the Zone exists or a [Not Found](/../api/errors#404-not-found) error otherwise.
       responses:
         "200":
           description: |-
@@ -40254,6 +40290,8 @@ paths:
         - oauth_2_0:
             - "manage_orders:{projectKey}"
       operationId: ByProjectKeyZonesByIDDelete
+      description: |-
+        Deletes a Zone in the Project.
       parameters:
         - name: version
           in: query