TASK: Updating RAML types, Postman and OAS definition

Author: ct-sdks[bot]

bruno/api/Project/Carts/ByProjectKeyCartsHead.bru

@@ -1,5 +1,5 @@
 meta {
-  name: Check carts are existing
+  name: Check if a Cart exists by Query Predicate
   type: http
   seq: 16
 }

oas/api/openapi.yaml

@@ -1538,7 +1538,7 @@ paths:
             - "manage_orders:{projectKey}"
       operationId: ByProjectKeyAsAssociateByAssociateIdInBusinessUnitKeyByBusinessUnitKeyCartsPost
       description: |-
-        Creates a [Cart](ctp:api:type:Cart) in the [BusinessUnit](ctp:api:type:BusinessUnit) referenced by `businessUnitKey`. As such, the `businessUnit` field on [CartDraft](ctp:api:type:CartDraft) is ignored for this request.
+        Creates a Cart in the [BusinessUnit](ctp:api:type:BusinessUnit) referenced by `businessUnitKey`. As such, the `businessUnit` field on [CartDraft](ctp:api:type:CartDraft) is ignored for this request.
         Creating a Cart can fail with an [InvalidOperation](ctp:api:type:InvalidOperationError) if the referenced [ShippingMethod](ctp:api:type:ShippingMethod) in the [CartDraft](ctp:api:type:CartDraft) has a predicate that does not match the Cart.
 
         Specific Error Codes:
@@ -5774,6 +5774,8 @@ paths:
         - oauth_2_0:
             - "view_orders:{projectKey}"
       operationId: ByProjectKeyCartsGet
+      description: |-
+        Retrieves all Carts in the Project.
       parameters:
         - name: expand
           in: query
@@ -5866,7 +5868,7 @@ paths:
             - "view_orders:{projectKey}"
       operationId: ByProjectKeyCartsHead
       description: |-
-        Checks if a Cart exists for a given Query Predicate. Returns a `200 OK` status if any Carts match the Query Predicate, or a `404 Not Found` otherwise.
+        Checks if one or more Carts exist for the provided query predicate. Returns a `200 OK` status if any Carts match the query predicate, or a `404 Not Found` otherwise.
       parameters:
         - name: where
           in: query
@@ -5902,6 +5904,8 @@ paths:
             - "manage_orders:{projectKey}"
       operationId: ByProjectKeyCartsPost
       description: |-
+        Creates a Cart in the Project.
+
         If the referenced [ShippingMethod](ctp:api:type:ShippingMethod) in the [CartDraft](ctp:api:type:CartDraft) has a predicate that does not match, or if the Shipping Method is not active, an [InvalidOperation](ctp:api:type:InvalidOperationError) error is returned.
 
         Specific Error Codes:
@@ -6009,7 +6013,7 @@ paths:
             - "view_orders:{projectKey}"
       operationId: ByProjectKeyCartsCustomerIdByCustomerIdHead
       description: |-
-        Checks if a Cart of a Customer exists. Returns a `200 OK` status if the Cart exists or a `404 Not Found` otherwise.
+        Checks if a Cart exists for a Customer. Returns a `200 OK` status if the Cart exists or a `404 Not Found` otherwise.
       responses:
         "200":
           description: |-
@@ -6047,6 +6051,7 @@ paths:
             - "view_orders:{projectKey}"
       operationId: ByProjectKeyCartsKeyByKeyGet
       description: |-
+        Retrieves a Cart with the provided `key`.
         To ensure the Cart is up-to-date with current values (such as Prices and Discounts), use the [Recalculate](ctp:api:type:CartRecalculateAction) update action.
       parameters:
         - name: expand
@@ -6087,7 +6092,7 @@ paths:
             - "view_orders:{projectKey}"
       operationId: ByProjectKeyCartsKeyByKeyHead
       description: |-
-        Checks if a Cart exists for a given `key`. Returns a `200 OK` status if the Cart exists or a `404 Not Found` otherwise.
+        Checks if a Cart exists for the provided `key`. Returns a `200 OK` status if the Cart exists or a `404 Not Found` otherwise.
       responses:
         "200":
           description: |-
@@ -6112,6 +6117,8 @@ paths:
         - oauth_2_0:
             - "manage_orders:{projectKey}"
       operationId: ByProjectKeyCartsKeyByKeyPost
+      description: |-
+        Updates a Cart in the Project using one or more [update actions](/../projects/carts#update-actions).
       parameters:
         - name: expand
           in: query
@@ -6158,6 +6165,8 @@ paths:
         - oauth_2_0:
             - "manage_orders:{projectKey}"
       operationId: ByProjectKeyCartsKeyByKeyDelete
+      description: |-
+        Deletes a Cart in the Project.
       parameters:
         - name: dataErasure
           x-annotation-default: false
@@ -6279,6 +6288,7 @@ paths:
             - "view_orders:{projectKey}"
       operationId: ByProjectKeyCartsByIDGet
       description: |-
+        Retrieves a Cart with the provided `id`.
         To ensure the Cart is up-to-date with current values (such as Prices and Discounts), use the [Recalculate](ctp:api:type:CartRecalculateAction) update action.
       parameters:
         - name: expand
@@ -6319,7 +6329,7 @@ paths:
             - "view_orders:{projectKey}"
       operationId: ByProjectKeyCartsByIDHead
       description: |-
-        Checks if a Cart exists for a given `id`. Returns a `200 OK` status if the Cart exists or a `404 Not Found` otherwise.
+        Checks if a Cart exists for the provided `id`. Returns a `200 OK` status if the Cart exists or a `404 Not Found` otherwise.
       responses:
         "200":
           description: |-
@@ -6344,6 +6354,8 @@ paths:
         - oauth_2_0:
             - "manage_orders:{projectKey}"
       operationId: ByProjectKeyCartsByIDPost
+      description: |-
+        Updates a Cart in the Project using one or more [update actions](/../projects/carts#update-actions).
       parameters:
         - name: expand
           in: query
@@ -6390,6 +6402,8 @@ paths:
         - oauth_2_0:
             - "manage_orders:{projectKey}"
       operationId: ByProjectKeyCartsByIDDelete
+      description: |-
+        Deletes a Cart in the Project.
       parameters:
         - name: dataErasure
           x-annotation-default: false
@@ -11803,7 +11817,7 @@ paths:
             - "view_orders:{projectKey}:{storeKey}"
       operationId: ByProjectKeyInStoreKeyByStoreKeyCartsGet
       description: |-
-        Queries Carts in a specific [Store](ctp:api:type:Store).
+        Retrieves all Carts in a [Store](ctp:api:type:Store).
       parameters:
         - name: expand
           in: query
@@ -11897,7 +11911,7 @@ paths:
             - "view_orders:{projectKey}:{storeKey}"
       operationId: ByProjectKeyInStoreKeyByStoreKeyCartsHead
       description: |-
-        Checks if a Cart exists for a given Query Predicate. Returns a `200 OK` status if any Carts match the Query Predicate or a [ResourceNotFound](ctp:api:type:ResourceNotFoundError) error otherwise.
+        Checks if one or more Carts exist for the provided query predicate in a [Store](ctp:api:type:Store). Returns a `200 OK` status if any Carts match the query predicate or a [ResourceNotFound](ctp:api:type:ResourceNotFoundError) error otherwise.
       parameters:
         - name: where
           in: query
@@ -11934,7 +11948,7 @@ paths:
             - "manage_orders:{projectKey}:{storeKey}"
       operationId: ByProjectKeyInStoreKeyByStoreKeyCartsPost
       description: |-
-        Creates a [Cart](ctp:api:type:Cart) in the [Store](ctp:api:type:Store) specified by `storeKey`.
+        Creates a Cart in a [Store](ctp:api:type:Store).
 
         If the referenced [ShippingMethod](ctp:api:type:ShippingMethod) in the [CartDraft](ctp:api:type:CartDraft) has a predicate that does not match, or if the Shipping Method is not active, an [InvalidOperation](ctp:api:type:InvalidOperationError) error is returned.
 
@@ -12053,7 +12067,7 @@ paths:
             - "view_orders:{projectKey}:{storeKey}"
       operationId: ByProjectKeyInStoreKeyByStoreKeyCartsCustomerIdByCustomerIdHead
       description: |-
-        Checks if a Cart of a Customer exists. Returns a `200 OK` status if the Cart exists or a [ResourceNotFound](ctp:api:type:ResourceNotFoundError) error otherwise.
+        Checks if one or more Carts exist for a Customer in a [Store](ctp:api:type:Store). Returns a `200 OK` status if the Cart exists or a [ResourceNotFound](ctp:api:type:ResourceNotFoundError) error otherwise.
       responses:
         "200":
           description: |-
@@ -12097,6 +12111,8 @@ paths:
             - "view_orders:{projectKey}:{storeKey}"
       operationId: ByProjectKeyInStoreKeyByStoreKeyCartsKeyByKeyGet
       description: |-
+        Retrieves a Cart with the provided `key` in a [Store](ctp:api:type:Store).
+
         If the Cart exists in the Project but does not have a `store` specified, or the `store` field references a different Store, this method returns a [ResourceNotFound](ctp:api:type:ResourceNotFoundError) error.
 
         To ensure the Cart is up-to-date with current values (such as Prices and Discounts), use the [Recalculate](ctp:api:type:CartRecalculateAction) update action.
@@ -12140,7 +12156,7 @@ paths:
             - "view_orders:{projectKey}:{storeKey}"
       operationId: ByProjectKeyInStoreKeyByStoreKeyCartsKeyByKeyHead
       description: |-
-        Checks if a Cart exists for a given `key`. Returns a `200 OK` status if the Cart exists or a [ResourceNotFound](ctp:api:type:ResourceNotFoundError) error otherwise.
+        Checks if a Cart exists for the provided `key` in a [Store](ctp:api:type:Store). Returns a `200 OK` status if the Cart exists or a [ResourceNotFound](ctp:api:type:ResourceNotFoundError) error otherwise.
       responses:
         "200":
           description: |-
@@ -12167,6 +12183,8 @@ paths:
             - "manage_orders:{projectKey}:{storeKey}"
       operationId: ByProjectKeyInStoreKeyByStoreKeyCartsKeyByKeyPost
       description: |-
+        Updates a Cart in a [Store](ctp:api:type:Store) using one or more [update actions](/../projects/carts#update-actions).
+
         If the Cart exists in the Project but does not have a `store` specified, or the `store` field references a different Store, this method returns a [ResourceNotFound](ctp:api:type:ResourceNotFoundError) error.
       parameters:
         - name: expand
@@ -12216,6 +12234,8 @@ paths:
             - "manage_orders:{projectKey}:{storeKey}"
       operationId: ByProjectKeyInStoreKeyByStoreKeyCartsKeyByKeyDelete
       description: |-
+        Deletes a Cart in a [Store](ctp:api:type:Store).
+
         If the Cart exists in the Project but does not have a `store` specified, or the `store` field references a different Store, this method returns a [ResourceNotFound](ctp:api:type:ResourceNotFoundError) error.
       parameters:
         - name: dataErasure
@@ -12350,6 +12370,8 @@ paths:
             - "view_orders:{projectKey}:{storeKey}"
       operationId: ByProjectKeyInStoreKeyByStoreKeyCartsByIDGet
       description: |-
+        Retrieves a Cart with the provided `id` in a [Store](ctp:api:type:Store).
+
         If the Cart exists in the Project but does not have a `store` specified, or the `store` field references a different Store, this method returns a [ResourceNotFound](ctp:api:type:ResourceNotFoundError) error.
 
         To ensure the Cart is up-to-date with current values (such as Prices and Discounts), use the [Recalculate](ctp:api:type:CartRecalculateAction) update action.
@@ -12393,7 +12415,7 @@ paths:
             - "view_orders:{projectKey}:{storeKey}"
       operationId: ByProjectKeyInStoreKeyByStoreKeyCartsByIDHead
       description: |-
-        Checks if a Cart exists for a given `id`. Returns a `200 OK` status if the Cart exists or a [ResourceNotFound](ctp:api:type:ResourceNotFoundError) error otherwise.
+        Checks if a Cart exists for the provided `id` in a Store. Returns a `200 OK` status if the Cart exists or a [ResourceNotFound](ctp:api:type:ResourceNotFoundError) error otherwise.
       responses:
         "200":
           description: |-
@@ -12420,7 +12442,8 @@ paths:
             - "manage_orders:{projectKey}:{storeKey}"
       operationId: ByProjectKeyInStoreKeyByStoreKeyCartsByIDPost
       description: |-
-        Updates a [Cart](ctp:api:type:Cart) in the [Store](ctp:api:type:Store) specified by `storeKey`.
+        Updates a Cart in a [Store](ctp:api:type:Store) using one or more [update actions](/../projects/carts#update-actions).
+
         If the Cart exists in the Project but does not have a `store` specified, or the `store` field references a different Store, this method returns a [ResourceNotFound](ctp:api:type:ResourceNotFoundError) error.
       parameters:
         - name: expand
@@ -12470,6 +12493,8 @@ paths:
             - "manage_orders:{projectKey}:{storeKey}"
       operationId: ByProjectKeyInStoreKeyByStoreKeyCartsByIDDelete
       description: |-
+        Deletes a Cart in a [Store](ctp:api:type:Store).
+
         If the Cart exists in the Project but does not have a `store` specified, or the `store` field references a different Store, this method returns a [ResourceNotFound](ctp:api:type:ResourceNotFoundError) error.
       parameters:
         - name: dataErasure