Skip to main content

CartUpdateItemInput

Input for updating existing cart items.

Extends the base cart item input with additional fields for price overrides. Used when modifying items already present in the shopping cart.

input CartUpdateItemInput {
  quantity: Int = 1
  notes: String
  requestDate: String
  attributes: [AttributeBulkCreateInput!]
  price: Float
}

Fields​

CartUpdateItemInput.quantity ● Int scalar​

Number of units to add to the cart.

Must be a positive integer. Defaults to 1 if not specified.

CartUpdateItemInput.notes ● String scalar​

Additional notes or special instructions for this item.

Maximum length of 255 characters. HTML tags will be automatically removed for security.

CartUpdateItemInput.requestDate ● String scalar​

Preferred delivery date for this specific item.

Must be provided in ISO 8601 date format (YYYY-MM-DD). Used for items that require specific delivery scheduling.

CartUpdateItemInput.attributes ● [AttributeBulkCreateInput!] list input​

Custom attributes for this cart item, captured on the item and forwarded to the order item on processing.

Additive: attributes you do not mention are always kept. An entry whose description is already stored overwrites its value; a new description is appended. To remove a single attribute, send it with a null value. An omitted array changes nothing.

An EMPTY array depends on the operation. On the update path (cartUpdateItem) it removes every attribute on this item in one call. On the add paths (cartAddItem, cartAddBundle) it is a no-op, so re-adding the same product never wipes the attributes already captured on the line.

CartUpdateItemInput.price ● Float scalar​

Override price per unit for this cart item.

When specified, replaces the calculated price with this custom value. Primarily used for external pricing systems or manual price adjustments. Must be a positive number with maximum 5 decimal places.

Member Of​

cartUpdateItem mutation