Refresh catalog

​

Request

curl -X POST https://api.interchange.io/api/v2/buyer/advertisers/12345/catalogs/summer-sale-2026/refresh \
  -H "Authorization: Bearer $SCOPE3_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "executeActivation": true }'

​

Parameters

​

Response

{
  "catalog": {
    "catalog_id": "summer-sale-2026",
    "action": "updated",
    "platform_id": "14",
    "item_count": 6,
    "items_approved": 6,
    "items_pending": 0,
    "items_rejected": 0,
    "health_status": "healthy"
  },
  "refreshRun": {
    "refreshRunId": "77",
    "status": "synced",
    "httpStatus": 200,
    "sourceContentHash": "abc123…",
    "itemCount": 6,
    "activationSkippedReason": null,
    "error": null,
    "startedAt": "2026-06-07T12:00:00Z",
    "completedAt": "2026-06-07T12:00:03Z"
  },
  "activation": null
}

• catalog — the sync result, with action created, updated, unchanged, failed, or deleted.
• refreshRun — the fetch run: status (syncing, synced, unchanged, failed), the feed httpStatus, the resulting itemCount, and activationSkippedReason when activation was requested but skipped (e.g. the feed was not modified).
• activation — the execution result when executeActivation was true and activation ran; otherwise null.

​

Errors

• 400 VALIDATION_ERROR — the catalog has no stored feed url (“Catalog does not have a stored feed URL…”), or the feed URL fails public-URL validation.
• 404 NOT_FOUND — advertiserId or catalogId does not exist or is not visible to the authenticated account.

​

Related