Skip to main content
POST /api/v2/buyer/discovery/{discoveryId}/products Adds products to the session selection. Each product must already have been surfaced by Discover products or Browse products — pass the productId, salesAgentId, groupId, and groupName from those results. Optionally pin a budget, pricing option, bid, or per-line-item targeting. By default products merge into the existing selection; set replace: true to swap the whole set.

Request

Parameters

Response

Returns the full selection after the add, so you do not need a separate Get products call to confirm.

Errors

  • 400 VALIDATION_ERROR — empty products, missing a required selection field, or a productId not present in the session’s discovery results.
  • 404 NOT_FOUNDdiscoveryId does not exist or is not visible to the authenticated account.
See Errors for the full error contract.

Discovery overview

Selection model and budget allocation

Get products

List the current selection

Remove products

Drop products from the selection

Apply proposal

Add a whole proposal at once