Updated API from documentation release

ct-sdks[bot] · ct-sdks[bot] · commit 1119815b3a93 · 2026-02-13T15:07:42.000Z
diff --git a/api-specs/api/types/cart/updates/CartAddItemShippingAddressAction.raml b/api-specs/api/types/cart/updates/CartAddItemShippingAddressAction.raml
@@ -5,7 +5,7 @@ displayName: CartAddItemShippingAddressAction
 discriminatorValue: addItemShippingAddress
 example: !include ../../../examples/Cart/CartAddItemShippingAddressAction.json
 description: |
-  Adds an address to a Cart when shipping to multiple addresses is desired.
+  Adds an address to the `itemShippingAddresses` of a Cart. Use this action when shipping is defined per item. For example, when shipping items to multiple addresses or when using different Shipping Methods, even if all items share the same address.
 properties:
   address:
     type: BaseAddress
diff --git a/api-specs/api/types/me/updates/MyCartAddItemShippingAddressAction.raml b/api-specs/api/types/me/updates/MyCartAddItemShippingAddressAction.raml
@@ -5,7 +5,7 @@ displayName: MyCartAddItemShippingAddressAction
 discriminatorValue: addItemShippingAddress
 example: !include ../../../examples/Cart/CartAddItemShippingAddressAction.json
 description: |
-  Adds an address to a Cart when shipping to multiple addresses is desired.
+  Adds an address to the `itemShippingAddresses` of a Cart. Use this action when shipping is defined per item. For example, when shipping items to multiple addresses or when using different Shipping Methods, even if all items share the same address.
 properties:
   address:
     type: BaseAddress
diff --git a/api-specs/api/types/order-edit/updates/StagedOrderAddItemShippingAddressAction.raml b/api-specs/api/types/order-edit/updates/StagedOrderAddItemShippingAddressAction.raml
@@ -5,7 +5,7 @@ type: StagedOrderUpdateAction
 displayName: StagedOrderAddItemShippingAddressAction
 discriminatorValue: addItemShippingAddress
 description: |
-  Adds an address to an Order when shipping to multiple addresses is desired.
+  Adds an address to the `itemShippingAddresses` of an Order. Use this action when shipping is defined per item. For example, when shipping items to multiple addresses or when using different Shipping Methods, even if all items share the same address.
 properties:
   address:
     type: BaseAddress
diff --git a/api-specs/api/types/order/updates/OrderAddItemShippingAddressAction.raml b/api-specs/api/types/order/updates/OrderAddItemShippingAddressAction.raml
@@ -5,7 +5,7 @@ type: OrderUpdateAction
 displayName: OrderAddItemShippingAddressAction
 discriminatorValue: addItemShippingAddress
 description: |
-  Adds an address to an Order when shipping to multiple addresses is desired.
+  Adds an address to the `itemShippingAddresses` of an Order. Use this action when shipping is defined per item. For example, when shipping items to multiple addresses or when using different Shipping Methods, even if all items share the same address.
 properties:
   address:
     type: BaseAddress
