Updated API from documentation release

Author: ct-sdks[bot]

api-specs/api/resources/as-associate.raml

@@ -255,7 +255,7 @@ type: base
         displayName: Create cart in business unit
         securedBy: [oauth_2_0: { scopes: ['manage_orders:{projectKey}'] }]
         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:

api-specs/api/resources/carts.raml

@@ -11,20 +11,25 @@ type:
 description: A shopping cart holds product variants and can be ordered.
 get:
   securedBy: [oauth_2_0: { scopes: ['view_orders:{projectKey}'] }]
+  description: Retrieves all Carts in the Project.
   responses:
     200:
       body:
         application/json:
           example: !include ../examples/carts.example.json
 head:
   securedBy: [oauth_2_0: { scopes: ['view_orders:{projectKey}'] }]
-  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.
+  displayName: Check if a Cart exists by Query Predicate
+  description: 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.
   queryParameters:
     where?:
       type: QueryPredicate[]
 post:
   securedBy: [oauth_2_0: { scopes: ['manage_orders:{projectKey}'] }]
   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:
@@ -87,7 +92,7 @@ post:
             example: !include ../examples/cart.example.json
   head:
     securedBy: [oauth_2_0: { scopes: ['view_orders:{projectKey}'] }]
-    description: Checks if a Cart of a Customer exists. Returns a `200 OK` status if the Cart exists or a `404 Not Found` otherwise.
+    description: Checks if a Cart exists for a Customer. Returns a `200 OK` status if the Cart exists or a `404 Not Found` otherwise.
 /key={key}:
   (methodName): withKey
   type:
@@ -98,6 +103,7 @@ post:
   get:
     securedBy: [oauth_2_0: { scopes: ['view_orders:{projectKey}'] }]
     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.
     responses:
       200:
@@ -106,8 +112,9 @@ post:
             example: !include ../examples/cart.example.json
   head:
     securedBy: [oauth_2_0: { scopes: ['view_orders:{projectKey}'] }]
-    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.
+    description: Checks if a Cart exists for the provided `key`. Returns a `200 OK` status if the Cart exists or a `404 Not Found` otherwise.
   post:
+    description: Updates a Cart in the Project using one or more [update actions](/../projects/carts#update-actions).
     securedBy: [oauth_2_0: { scopes: ['manage_orders:{projectKey}'] }]
     body:
       application/json:
@@ -121,6 +128,7 @@ post:
     is:
       - dataErasure
     securedBy: [oauth_2_0: { scopes: ['manage_orders:{projectKey}'] }]
+    description: Deletes a Cart in the Project.
     responses:
       200:
         body:
@@ -136,6 +144,7 @@ post:
   get:
     securedBy: [oauth_2_0: { scopes: ['view_orders:{projectKey}'] }]
     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.
     responses:
       200:
@@ -144,9 +153,10 @@ post:
             example: !include ../examples/cart.example.json
   head:
     securedBy: [oauth_2_0: { scopes: ['view_orders:{projectKey}'] }]
-    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.
+    description: Checks if a Cart exists for the provided `id`. Returns a `200 OK` status if the Cart exists or a `404 Not Found` otherwise.
   post:
     securedBy: [oauth_2_0: { scopes: ['manage_orders:{projectKey}'] }]
+    description: Updates a Cart in the Project using one or more [update actions](/../projects/carts#update-actions).
     body:
       application/json:
         example: !include ../examples/cart-update.example.json
@@ -159,6 +169,7 @@ post:
     is:
       - dataErasure
     securedBy: [oauth_2_0: { scopes: ['manage_orders:{projectKey}'] }]
+    description: Deletes a Cart in the Project.
     responses:
       200:
         body:

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

@@ -28,7 +28,7 @@ uriParameters:
           },
       ]
     displayName: Query Carts in Store
-    description: Queries Carts in a specific [Store](ctp:api:type:Store).
+    description: Retrieves all Carts in a [Store](ctp:api:type:Store).
     responses:
       200:
         body:
@@ -47,12 +47,11 @@ uriParameters:
               ],
           },
       ]
-    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.
+    description: 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.
     queryParameters:
       where?:
         type: QueryPredicate[]
   post:
-    displayName: Create Cart in Store
     securedBy:
       [
         oauth_2_0:
@@ -64,8 +63,9 @@ uriParameters:
               ],
           },
       ]
+    displayName: Create Cart in Store
     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.
 
@@ -128,7 +128,7 @@ uriParameters:
                 ],
             },
         ]
-      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.
+      description: 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.
   /key={key}:
     (methodName): withKey
     type:
@@ -150,6 +150,9 @@ uriParameters:
             },
         ]
       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.
@@ -171,7 +174,7 @@ uriParameters:
                 ],
             },
         ]
-      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.
+      description: 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.
     post:
       displayName: Update Cart in Store by Key
       securedBy:
@@ -186,6 +189,8 @@ uriParameters:
             },
         ]
       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.
       body:
         application/json:
@@ -198,6 +203,8 @@ uriParameters:
     delete:
       displayName: Delete Cart in Store by Key
       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.
       is:
         - dataErasure
@@ -274,6 +281,8 @@ uriParameters:
             },
         ]
       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.
@@ -295,7 +304,7 @@ uriParameters:
                 ],
             },
         ]
-      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.
+      description: 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.
     post:
       displayName: Update Cart in Store by ID
       securedBy:
@@ -310,7 +319,8 @@ uriParameters:
             },
         ]
       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.
       body:
         application/json:
@@ -323,6 +333,8 @@ uriParameters:
     delete:
       displayName: Delete Cart in Store by ID
       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.
       is:
         - dataErasure