Skip to main content
DELETE /api/v2/storefront/inventory-sources/{sourceId} Deletes an inventory source. The linked agent is disabled before the row is removed.

​
Request

curl -X DELETE https://api.interchange.io/api/v2/storefront/inventory-sources/retail-network-agent \
  -H "Authorization: Bearer $SCOPE3_API_KEY"

​
Parameters

FieldTypeRequiredNotes
sourceIdstring (path)YesStorefront-scoped inventory source ID

​
Response

204 No Content — no response body on success.
A source cannot be deleted while its backing agent has non-terminal media buys (ACTIVE, PAUSED, PENDING_APPROVAL, or INPUT_REQUIRED). Cancel or terminate those first.

​
Errors

  • 400 VALIDATION_ERROR — the backing agent still has non-terminal media buys.
  • 401 UNAUTHORIZED — missing or invalid API key.
  • 404 NOT_FOUND — no source with this sourceId on your storefront.
See Errors for the full error contract.

Inventory source tasks

All operations

Inventory sources overview

Concepts and lifecycle

Update inventory source

Disable instead of delete

List inventory sources

Every source on the storefront