What parameters does PUT /V1/carts/:cartId/items/:itemId accept?

This endpoint accepts 1 parameter: cartItem (Magento\Quote\Api\Data\CartItemInterface) required.

What does PUT /V1/carts/:cartId/items/:itemId return?

The endpoint returns Magento\Quote\Api\Data\CartItemInterface.

Does PUT /V1/carts/:cartId/items/:itemId require authentication?

This endpoint requires an admin Bearer token with ACL: Magento_Cart::manage.

MageSmith

PUTQuote · Magento 2.4.9 Admin · Magento_Cart::manage

PUT /V1/carts/:cartId/items/:itemId

Q: What does the PUT /V1/carts/:cartId/items/:itemId endpoint do in Magento 2?

PUT /V1/carts/:cartId/items/:itemId is a Magento 2 REST endpoint in the Quote module. Add/update the specified cart item. Requires an admin Bearer token with ACL Magento_Cart::manage.

PUT /V1/carts/:cartId/items/:itemId is a Magento 2 REST endpoint in the Quote module. Add/update the specified cart item. Requires an admin Bearer token with ACL Magento_Cart::manage.

Last verified: 2026-05-23 against Magento 2.4.9.

Returns

Magento\Quote\Api\Data\CartItemInterface

Item.

Service contract

Magento\Quote\Api\CartItemRepositoryInterface::save

Authorization

Admin Bearer token with ACL:

Magento_Cart::manage

Body parameters

cartItem Magento\Quote\Api\Data\CartItemInterface Required

The item.

Example request

Auto-generated from the service contract — paste-ready against your store's /rest/default base. Replace the host, store code, ACL token, and any required values before running.

Headers

application/json

Content-Type

application/json

Authorization

Bearer <ACCESS_TOKEN> admin token with ACL: Magento_Cart::manage

Path

/V1/carts/:cartId/items/:itemId

Body

{
  "cartItem": {
    "extension_attributes": {},
    "item_id": 0,
    "name": "",
    "price": 0,
    "product_option": {
      "extension_attributes": {}
    },
    "product_type": "",
    "qty": 0,
    "quote_id": "",
    "sku": ""
  }
}