Deactivate ad-server source

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

Field	Type	Required	Notes
`sourceId`	string (path)	Yes	Storefront-scoped inventory source ID

Response

200 OK with the EsaConnection, now deactivated (deactivatedAt is set):

{
  "id": "550199",
  "customerId": 4210,
  "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
}

deactivatedAt is set, which disables the source. 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

Create a modular source from a feed Delete inventory source

⌘I

Getting Started

Operating Your Storefront

Inventory Sources

Real-Time Targeting (TMP)

Approvals & Reviews

Buyer Onboarding

Demand & Signals

Proposals & Agents

Buyer Routing

Analytics & Activity

Billing

Account

Deactivate ad-server source

Request

Parameters

Response

Errors

Inventory source tasks

Reactivate

Get ad-server connection

Inventory sources overview

​Request

​Parameters

​Response

​Errors

​Related

Inventory source tasks

Reactivate

Get ad-server connection

Inventory sources overview

Request

Parameters

Response

Errors

Related