Skip to main content
POST /api/v2/storefront/inventory-sources/{sourceId}/refresh Forces a refresh of the upstream managed-source status cache. Call it when a recent change upstream hasn’t surfaced yet in Get status.

​
Request

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

​
Parameters

FieldTypeRequiredNotes
sourceIdstring (path)YesStorefront-scoped inventory source ID

​
Response

{
  "status": "started",
  "syncRunIds": { "inventory": "run_01J2..." },
  "startedAt": "2026-05-02T09:25:00Z",
  "runningSyncTypes": ["inventory"]
}
status is started when the upstream accepted the refresh request, or already_running when a sync is already in flight. syncRunIds maps sync-type keys to upstream run IDs for correlation. Read the refreshed snapshot with Get status.

​
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

Get status

Read the refreshed snapshot

List sync history

Per-run sync drill-down

Test connection

Probe upstream reachability