Skip to main content
POST /api/v2/storefront/inventory-sources/{sourceId}/deactivate Soft-deletes the ad-server source. The connection row stays in place so the storefront can re-provision later with Reactivate.

​
Request

curl -X POST https://api.interchange.io/api/v2/storefront/inventory-sources/retail-gam/deactivate \
  -H "Authorization: Bearer $SCOPE3_API_KEY"

​
Parameters

FieldTypeRequiredNotes
sourceIdstring (path)YesStorefront-scoped inventory source ID

​
Response

200 OK with the EsaConnection in deactivated state: 
{
  "id": "550199",
  "customerId": 4210,
  "provisioningStatus": "deactivated",
  "tenantId": "tnt_retail_gam",
  "mcpUrl": "/mcp/",
  "a2aUrl": "/a2a",
  "adServer": { "type": "google_ad_manager", "networkCode": "12345678" },
  "serviceAccountEmail": "retail-gam-4210@scope3-esa.iam.gserviceaccount.com",
  "lastError": null,
  "lastErrorCode": null,
  "lastTestedAt": "2026-05-01T09:00:00Z",
  "provisionedAt": "2026-04-25T12:10:00Z",
  "deactivatedAt": "2026-05-02T10:00:00Z",
  "createdAt": "2026-04-25T12:05:00Z",
  "updatedAt": "2026-05-02T10:00:00Z",
  "inventorySync": null
}
provisioningStatus becomes deactivated and deactivatedAt is set. The row is preserved for re-provisioning.

​
Errors

  • 401 UNAUTHORIZED — missing or invalid API key.
  • 404 NOT_FOUND — no ad-server-backed source with this sourceId.
See Errors for the full error contract.

Inventory source tasks

All operations

Reactivate

Re-enable this source

Get ad-server connection

Connection state

Inventory sources overview

Concepts and lifecycle