Remove products

DELETE /api/v2/buyer/discovery/{discoveryId}/products Removes products from the session selection. Use productIds for legacy product-wide removal, or productRefs when you need to remove one exact inventory-source variant or repeat selection. 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

Field	Type	Required	Notes
`discoveryId`	string	Yes	Path param — session to modify
`productIds`	string[]	No*	Product IDs to remove. Each ID removes every matching selection instance.
`productRefs`	object[]	No*	Exact references to remove. Include `productId` and, when returned by discovery, `inventorySourceId` or `selectionId`.

*Provide at least one non-empty productIds or productRefs array. To remove only one inventory-source variant when two selected products share a storefront and product ID, send the exact provenance returned by discovery:

{
  "productRefs": [
    {
      "productId": "sf1:42:d2g6c2hhcmVkLXByb2R1Y3Q",
      "inventorySourceId": "200"
    }
  ]
}

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 — neither removal array contains a target.
404 NOT_FOUND — discoveryId 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

Add products

Add products to the selection

Start building

Core Concepts

Buyer operations

Seller operations

Cross-Cutting Reference

Buyer API reference

Seller API reference

Release Notes

Request

Parameters

Response

Errors

Discovery overview

Get products

Add products

​Request

​Parameters

​Response

​Errors

​Related

Discovery overview

Get products

Add products

Request

Parameters

Response

Errors

Related