The cartDeliveryAddressesUpdate mutation now supports removing all addresses from a cart

To clear all delivery addresses associated with a cart, you can now call the cartDeliveryAddressesUpdate mutation and set addresses to an empty array([]).

Previously, to clear a cart’s addresses, you could call the cartBuyerIdentityUpdate mutation and set buyerIdentity.deliveryAddressPreferences to an empty array. However, deliveryAddressPreferences is deprecated.

Action required before API version 2025-10

Review your existing code. Starting with API version 2025-10, setting the addresses field of the cartDeliveryAddressesUpdate mutation to an empty array ([]) clears cart addresses. If you do not want this behavior, update your code.