Update cart

Updates multiple cart items or properties at once.

POST /cart/update

Update cart

cURL

curl --request POST \
  --url {protocol}://{host}/wp-json/cocart/v2/cart/update \
  --header 'Content-Type: application/json' \
  --data '
{
  "namespace": "<string>",
  "items": {},
  "data": {}
}
'

200

{
  "cart_hash": "<string>",
  "cart_key": "<string>",
  "currency": {
    "currency_code": "<string>",
    "currency_symbol": "<string>",
    "currency_symbol_pos": "<string>",
    "currency_minor_unit": 123,
    "currency_decimal_separator": "<string>",
    "currency_thousand_separator": "<string>",
    "currency_prefix": "<string>",
    "currency_suffix": "<string>"
  },
  "customer": {
    "billing_address": {
      "billing_first_name": "<string>",
      "billing_last_name": "<string>",
      "billing_company": "<string>",
      "billing_country": "<string>",
      "billing_address_1": "<string>",
      "billing_address_2": "<string>",
      "billing_postcode": "<string>",
      "billing_city": "<string>",
      "billing_state": "<string>",
      "billing_phone": "<string>",
      "billing_email": "<string>"
    },
    "shipping_address": {
      "shipping_first_name": "<string>",
      "shipping_last_name": "<string>",
      "shipping_company": "<string>",
      "shipping_country": "<string>",
      "shipping_address_1": "<string>",
      "shipping_address_2": "<string>",
      "shipping_postcode": "<string>",
      "shipping_city": "<string>",
      "shipping_state": "<string>"
    }
  },
  "items": {},
  "item_count": 123,
  "items_weight": 123,
  "coupons": [
    {
      "coupon": "<string>",
      "label": "<string>",
      "saving": "<string>",
      "saving_html": "<string>"
    }
  ],
  "needs_payment": true,
  "needs_shipping": true,
  "shipping": {
    "total_packages": 123,
    "show_package_details": true,
    "has_calculated_shipping": true,
    "packages": {}
  },
  "fees": [
    {
      "name": "<string>",
      "amount": 123,
      "taxable": true,
      "tax_class": "<string>",
      "total": 123,
      "tax": 123
    }
  ],
  "taxes": [
    {
      "rate_id": 123,
      "label": "<string>",
      "compound": true,
      "tax_total": "<string>",
      "shipping_tax_total": "<string>"
    }
  ],
  "totals": {
    "subtotal": "<string>",
    "subtotal_tax": "<string>",
    "shipping_total": "<string>",
    "shipping_tax": "<string>",
    "shipping_taxes": [
      123
    ],
    "discount_total": "<string>",
    "discount_tax": "<string>",
    "cart_contents_total": "<string>",
    "cart_contents_tax": "<string>",
    "cart_contents_taxes": [
      123
    ],
    "fee_total": "<string>",
    "fee_tax": "<string>",
    "fee_taxes": [
      123
    ],
    "total": "<string>",
    "total_tax": "<string>"
  },
  "removed_items": [
    {
      "key": "<string>",
      "product_id": 123,
      "quantity": 123,
      "name": "<string>"
    }
  ],
  "cross_sells": [
    {
      "id": 123,
      "product_name": "<string>",
      "product_title": "<string>",
      "price": "<string>",
      "regular_price": "<string>",
      "sale_price": "<string>",
      "product_image": "<string>"
    }
  ],
  "notices": {},
  "extensions": {}
}

Body

application/json

namespace · string · required

Namespace used to ensure the data in the request is routed appropriately.

items · object

Items to update in the cart.

Show child attributes

data · object

Additional data to pass.

Response

200

application/json

Cart updated successfully.

Complete cart object with enhanced v2 structure.

cart_hash · string

Unique cart hash.

cart_key · string

Unique cart key for the customer.

currency · object

Show child attributes

customer · object

Show child attributes

items · object

Cart items indexed by item key.

Show child attributes

item_count · integer

Total number of items in cart.

items_weight · number

Total weight of all items.

coupons · object[]

Applied coupons.

Show child attributes

needs_payment · boolean

Whether the cart needs payment.

needs_shipping · boolean

Whether the cart needs shipping.

shipping · object

Show child attributes

fees · object[]

Cart fees.

Show child attributes

taxes · object[]

Cart taxes.

Show child attributes

totals · object

Show child attributes

removed_items · object[]

Recently removed items that can be restored.

Show child attributes

cross_sells · object[]

Cross-sell products.

Show child attributes

notices · object

Cart notices and messages.

extensions · object

Additional data from extensions.