Home > widget-integration > CartAPI > change
CartAPI.change() method
Change cart item quantity with automatic retry on conflicts Uses exponential backoff strategy for 409 Conflict errors
Signature:
change(id: string | number, quantity?: number, retryCount?: number): Promise<CartChangeResponse>;
Parameters
|
Parameter |
Type |
Description |
|---|---|---|
|
id |
string | number |
Product variant ID or cart line item ID |
|
quantity |
number |
(Optional) New quantity (0 to remove item) |
|
retryCount |
number |
(Optional) Internal retry counter (do not set manually) |
Returns:
Promise<CartChangeResponse>
Promise resolving to updated cart data
Exceptions
Error if update fails after all retries
Example
await cartAPI.change('12345', 2); // Set quantity to 2
await cartAPI.change('12345', 0); // Remove item