Updates a Cart line item. Updates an existing, single line item quantity and the price of custom items in a cart.
If a modified product or variant needs to be changed or updated, you can remove and re-add the product to the cart with the correct variants using the Delete Cart Line Item and the Add Cart Line Items endpoints. You can also use carts mutations that are part of the GraphQL Storefront API.
Notes
Substitute your storefront domain for yourstore.example.com.
The Send a Test Request feature is not currently supported for this endpoint.
Please note that this API endpoint is not concurrent safe, meaning multiple simultaneous requests could result in unexpected and inconsistent results.
Parameters
store_domain in path - string
Body
application/json
Any of:Line itemGift certificate itemline & gift certificate items
lineItem
required
Any of:Simple productProduct with a variant
productIdnumber
required
ID of the product.
quantitynumber
required
Quantity of this item.
giftWrappingobject or null
if passing null, it will remove the current gift wrapping for the item
Variant Item
JSONJavaScript: FetchJavaScript: Axios
Custom Item
JSONJavaScript: FetchJavaScript: Axios
With Gift Wrapping
JSONJavaScript: FetchJavaScript: Axios
With null Gift Wrapping (will delete current gift wrapping)
JSONJavaScript: FetchJavaScript: Axios
Response
200
Body
object | application/json
Cart object used in REST Storefront API cart responses.
idstring
Cart ID, provided after creating a cart with a POST.
customerIdinteger
ID of the customer to which the cart belongs.
emailstring
The cart's email. This is the same email that is used in the billing address
currencyobject
This will always be the same between cart and checkout.
isTaxIncludedboolean
Whether this item is taxable.
baseAmountnumber
Cost of cart’s contents, before applying discounts.
discountAmountnumber
Order based discounted amount only - Coupon discounts and product based discounts are excluded.
cartAmountnumber
Sum of line-items amounts, minus cart-level discounts and coupons. This amount includes taxes (where applicable).
Removing the last line_item in the Cart deletes the Cart.
Note
Substitute your storefront domain for yourstore.example.com.
The Send a Test Request feature is not currently supported for this endpoint.
Parameters
store_domain in path - string
example
JavaScript: FetchJavaScript: Axios
Response
200
NOTE: Discounted line items are re-evaluated on cart actions and may be automatically added back to your cart with a new line item ID to satisfy promotional requirements.
Body
object | application/json
Cart object used in REST Storefront API cart responses.
idstring
Cart ID, provided after creating a cart with a POST.
customerIdinteger
ID of the customer to which the cart belongs.
emailstring
The cart's email. This is the same email that is used in the billing address
currencyobject
This will always be the same between cart and checkout.
isTaxIncludedboolean
Whether this item is taxable.
baseAmountnumber
Cost of cart’s contents, before applying discounts.
discountAmountnumber
Order based discounted amount only - Coupon discounts and product based discounts are excluded.
cartAmountnumber
Sum of line-items amounts, minus cart-level discounts and coupons. This amount includes taxes (where applicable).