Updated API from documentation release

Author: ct-sdks[bot]

api-specs/api/resources/in-store.raml

@@ -2158,6 +2158,7 @@ uriParameters:
         Retrieves all 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).
+        If a matching ShippingMethod has `isDefault` set to `true`, it is returned as the first item in the array.
       is:
         - expandable
       securedBy:

api-specs/api/resources/shipping-methods.raml

@@ -149,6 +149,7 @@ post:
       Retrieves all 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).
+      If a matching ShippingMethod has `isDefault` set to `true`, it is returned as the first item in the array.
     is:
       - expandable
     securedBy:
@@ -192,7 +193,7 @@ post:
         type: string
         description: |
           ID of the Cart with a shipping address set.
-    description: Checks if an active ShippingMethod exists for the given Cart. Returns a `200 OK` status if the ShippingMethod exists or a `404 Not Found` otherwise.
+    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 OK` status if the ShippingMethod exists or a `404 Not Found` otherwise.
 /matching-cart-location:
   type: base
   description: Get ShippingMethods for a cart and location
@@ -203,6 +204,7 @@ post:
       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).
+      If a matching ShippingMethod has `isDefault` set to `true`, it is returned as the first item in the array.
     is:
       - expandable
     securedBy:
@@ -270,7 +272,7 @@ post:
     displayName: Get ShippingMethods for an order edit
     description: |
       Retrieves all the active ShippingMethods that can ship to the given [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.
     securedBy:
       [
@@ -337,6 +339,7 @@ post:
       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.
     is:
       - expandable
       - sortable

api-specs/api/types/shipping-method/ShippingMethod.raml

@@ -64,7 +64,8 @@ properties:
     default: true
   isDefault:
     type: boolean
-    description: If `true`, this ShippingMethod is the [Project](ctp:api:type:Project)'s default ShippingMethod.
+    description: |
+      If `true`, this ShippingMethod is the [Project](ctp:api:type:Project)'s default ShippingMethod. When retrieving [matching Shipping Methods](/projects/shippingMethods#get-matching-shipping-methods), it is returned as the first item in the array. This flag does not automatically apply the Shipping Method to Carts.
   predicate?:
     type: string
     description: |

api-specs/api/types/shipping-method/ShippingMethodDraft.raml

@@ -37,7 +37,8 @@ properties:
       If set to `true`, the ShippingMethod can be used during the creation or update of a Cart or Order.
     default: true
   isDefault:
-    description: If set to `true`, the ShippingMethod will be the [Project](ctp:api:type:Project)'s default ShippingMethod.
+    description: |
+      If set to `true`, the ShippingMethod will be the [Project](ctp:api:type:Project)'s default ShippingMethod. When retrieving [matching Shipping Methods](/projects/shippingMethods#get-matching-shipping-methods), it is returned as the first item in the array. This flag does not automatically apply the Shipping Method to Carts.
     type: boolean
   predicate?:
     type: string