Remove item from cart

DELETE 
/api/v1/sdk/cart/store/:storeId/item/:cartItemId

This endpoint removes a specific item from the customer's cart completely, regardless of quantity.

Authentication: Requires customer authentication (JWT token with verified phone). Optional API key for additional store validation.

Use Cases:

• Removing unwanted items from cart
  • Cart cleanup operations
  • Implementing remove buttons in cart UI

Behavior:

• Item is completely removed from cart
  • Cart totals are recalculated
  • If this was the last item, cart becomes empty but is not deleted

Error Scenarios:

• 404 NOT FOUND - Cart item not found (Error code: CART_ITEM_NOT_FOUND)
  • 401 UNAUTHORIZED - Customer not authenticated (Error code: UNAUTHORIZED)
  • 403 FORBIDDEN - API key doesn't have access to this store or item belongs to different customer (Error code: NO_STORE_ACCESS or UNAUTHORIZED_CART_ACCESS)

Request

Responses

200

Cart item removed successfully

401

Unauthorized - Customer authentication required

403

Forbidden - No access to this store or cart

404

Cart item not found

500

Internal server error