Cart

Update an existing cart line item

Mutate quantity, swap variant within the same product, switch tender, or update gift personalization. Pre-gates on UNIQUE collision (cart_id, product_id, variant_id, tender): a tender/variant swap that would collide with another line returns 409 line_collision so the client can merge first.

patch/api/v1/cart/items/{lineItemId}

Request

  • Base URL: https://makeup.land
  • URL: https://makeup.land/api/v1/cart/items/{lineItemId}
  • Auth: HTTP bearer and API key in query parameter phone

Path parameters

lineItemIdstring required

Headers

Idempotency-Keystring

Optional client-generated idempotency token (recommended: UUIDv4). Retries with the same key within 24h replay the original response.

Request body

phonestring

Phone number in E.164 format, e.g. +972501234567

quantityinteger
variant_idstring

Must belong to the same product as the current line

tender'ils' | 'credits'

Per-line tender. ils debits the order subtotal in shekels; credits debits the customer's ℳ-credit wallet. A variant must be priceable in the requested tender or the request is rejected with tender_unavailable.

gift_personalizationobject nullable

Response

Line updated

oktrue required
cart_idstring required
line_item_idstring required

Changes

No recorded changes to this operation across all 1 revision of this API.