Skip to main content
Each item is one thing the buyer needs, with how many (quantity, null when they haven’t said). Its options are the models they would accept. Several options mean any one of them, not several purchases.
  • Leave options empty until the buyer names a model. Never choose a model for them.
  • Open each product link the buyer gives. Send its brand, model and selected attributes; leave unspecified attributes open.
  • Sellers can count a Request once each item has the brand and model of every option, and a quantity. Until then list_requests flags details_needed.
  • An item is required unless the buyer says it is optional. With several items, all_items_required records whether they want only the whole set.

Changing items

In update_request, a field you leave out stays as it is and null clears it. Listing an item’s options replaces that item’s options. Name an item by item_id to change it, leave item_id out to add one, and send remove: true to delete one. The exact rules your agent receives are on Agent rules.