Updated API from documentation release

Author: ct-sdks[bot]

api-specs/api/resources/carts.raml

@@ -114,8 +114,7 @@ post:
     displayName: Merge Cart
     securedBy: [oauth_2_0: { scopes: ['manage_orders:{projectKey}'] }]
     description: |
-      Merges items from an anonymous Cart into the most recently modified active Cart of a Customer. If no active Cart exists, a [ResourceNotFound](ctp:api:type:ResourceNotFoundError) error is returned.
-
+      Merges items from an anonymous Cart into the most recently modified active Cart of a Customer. If no active Cart exists, the anonymous Cart becomes the Customer's active Cart.
       For more information, see [Merge behavior](/../api/carts-orders-overview#merge-behavior).
 
     body:

api-specs/api/resources/customers.raml

@@ -29,6 +29,8 @@ post:
   displayName: Create (sign up) Customer
   securedBy: [oauth_2_0: { scopes: ['manage_customers:{projectKey}'] }]
   description: |
+    Allows converting an anonymous Cart to the active Cart of a Customer with [cart merge](/../api/customers-overview#cart-merge-during-sign-in-and-sign-up).
+
     Creating a Customer produces the [CustomerCreated](ctp:api:type:CustomerCreatedMessage) Message. Simultaneously creating two Customers with the same email address can return a [LockedField](ctp:api:type:LockedFieldError) error.
   body:
     application/json:

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

@@ -137,7 +137,7 @@ post:
           },
       ]
     description: |
-      Merges items from an anonymous Cart into the most recently modified active Cart of a Customer. If no active Cart exists, a [ResourceNotFound](ctp:api:type:ResourceNotFoundError) error is returned.
+      Merges items from an anonymous Cart into the most recently modified active Cart of a Customer. If no active Cart exists, the anonymous Cart becomes the Customer's active Cart.
 
       If the Cart exists in the Project but does not have a `store` specified, or the `store` field references a different Store, a [ResourceNotFound](ctp:api:type:ResourceNotFoundError) error is returned.
 

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

@@ -46,7 +46,8 @@ post:
 
     If a Cart with a `store` field specified, the `store` field must reference the same [Store](ctp:api:type:Store) specified in the `{storeKey}` path parameter.
 
-    If the Customer has multiple active Carts, the anonymous Cart is [merged](/../api/customers-overview#cart-merge-during-sign-in-and-sign-up) into the most recently modified active Cart.
+    Allows converting an anonymous Cart to the active Cart of a Customer with [cart merge](/../api/customers-overview#cart-merge-during-sign-in-and-sign-up).
+    If the Customer has multiple active Carts, the anonymous Cart is merged into the most recently modified active Cart.
 
     Creating a Customer produces the [CustomerCreated](ctp:api:type:CustomerCreatedMessage) Message. Simultaneously creating two Customers with the same email address can return a [LockedField](ctp:api:type:LockedFieldError) error.
   body:

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

@@ -26,7 +26,9 @@ uriParameters:
     description: |
       Authenticates a Customer associated with a [Store](ctp:api:type:Store).
 
-      If the Customer has multiple active Carts, the anonymous Cart is [merged](/../api/customers-overview#cart-merge-during-sign-in-and-sign-up) into the most recently modified active Cart.
+      Allows [merging](/../api/customers-overview#cart-merge-during-sign-in-and-sign-up) items from an anonymous Cart into the most recently modified active Cart of a Customer.
+      If no active Cart exists, the anonymous Cart becomes the Customer's active Cart.
+      If the Customer has multiple active Carts, the anonymous Cart is merged into the most recently modified active Cart.
 
       If the Customer exists in the Project but the `stores` field references a different [Store](ctp:api:type:Store), this method returns an [InvalidCredentials](ctp:api:type:InvalidCredentialsError) error.
     securedBy:

api-specs/api/resources/login.raml

@@ -5,7 +5,9 @@ post:
   description: |
     Authenticates a global Customer.
 
-    If the Customer has multiple active Carts, the anonymous Cart is [merged](/../api/customers-overview#cart-merge-during-sign-in-and-sign-up) into the most recently modified active Cart.
+    Allows [merging](/../api/customers-overview#cart-merge-during-sign-in-and-sign-up) items from an anonymous Cart into the most recently modified active Cart of a Customer.
+    If no active Cart exists, the anonymous Cart becomes the Customer's active Cart.
+    If the Customer has multiple active Carts, the anonymous Cart is merged into the most recently modified active Cart.
 
     If an account with the given credentials is not found, an [InvalidCredentials](ctp:api:type:InvalidCredentialsError) error is returned.
   securedBy: [oauth_2_0: { scopes: ['manage_customers:{projectKey}'] }]