input_object

CartItem

Input for adding items to cart.
Fields
_custom_json
JSON
Custom JSON at article level. Example: { gift_wrap: true }
article_assignment
ArticleAssignmentInput
Article assignment rules (level/strategy). Example: { level: 'item', strategy: 'fast-delivery/optimal' }
article_id
String
Unique identifier of an article. Example: '5fdc737e3c05146138192f79'
display
String
Display text at article level. Example: 'Limited Edition'
extra_meta
JSON
Additional metadata at article level. Example: { color: 'Red' }
item_id
Int
Product identifier. Example: 987654
item_size
String
Size of the product. Example: 'M'
meta
JSON
Metadata at article level. Example: { source: 'PDP' }
parent_item_identifiers
[JSON]
Parent product identifiers. Example: [{ parent_item_id: 111, relation: 'bundle' }]
Whether request is made from POS. Example: false
product_group_tags
[String]
Product group tags for the item. Example: ['buy-1-get-1', 'clearance']
quantity
Int
Quantity to add. Example: 2
seller_id
Int
Selected seller ID. Example: 5678
store_id
Int
Selected store ID. Example: 1234
seller_identifier
String
Seller identifier for Store OS. Example: 'SELLER-001'
fulfillment_option_slug
String
Fulfillment method slug. Example: 'home-delivery' or 'store-pickup'
pickup_store_id
Int
Pickup store ID for store pickup. Example: 2001
force_new_line_item
Boolean
If true, forces a separate line item. Example: true