Skip to main content
DELETE /api/v2/buyer/discovery/{discoveryId}/products Removes products from the session selection by productId. Products that are not in the selection are ignored. Returns the remaining selection and refreshed budget context.

​
Request

curl -X DELETE https://api.interchange.io/api/v2/buyer/discovery/disc_01HZX3YQ7K9R6V3M2P1E0F8B2T/products \
  -H "Authorization: Bearer $SCOPE3_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "productIds": ["prod_acme_ctv_sports"] }'

​
Parameters

FieldTypeRequiredNotes
discoveryIdstringYesPath param — session to modify
productIdsstring[]YesProduct IDs to remove from the selection (min 1)

​
Response

{
  "discoveryId": "disc_01HZX3YQ7K9R6V3M2P1E0F8B2T",
  "products": [],
  "totalProducts": 0,
  "budgetContext": { "sessionBudget": 250000, "allocatedBudget": 0, "remainingBudget": 250000 }
}
Returns the full remaining selection. Freed budget is reflected in budgetContext.remainingBudget.

​
Errors

  • 400 VALIDATION_ERROR — empty productIds.
  • 404 NOT_FOUND — discoveryId does not exist or is not visible to the authenticated customer.
See Errors for the full error contract.

Discovery overview

Selection model and budget allocation

Get products

List the current selection

Add products

Add products to the selection