> ## Documentation Index
> Fetch the complete documentation index at: https://docs.interchange.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Refresh status snapshot

> Force a refresh of the cached managed-source status

`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](/v2/storefront/inventory-sources/tasks/get-status).

## Request

<CodeGroup>
  ```bash curl theme={null}
  curl -X POST https://api.interchange.io/api/v2/storefront/inventory-sources/retail-gam/refresh \
    -H "Authorization: Bearer $SCOPE3_API_KEY"
  ```
</CodeGroup>

## Parameters

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

## Response

```json theme={null}
{
  "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](/v2/storefront/inventory-sources/tasks/get-status).

## Errors

* `401 UNAUTHORIZED` — missing or invalid API key.
* `404 NOT_FOUND` — no ad-server-backed source with this `sourceId`.

See [Errors](/v2/reference/errors) for the full error contract.

## Related

<CardGroup cols={2}>
  <Card title="Inventory source tasks" href="/v2/storefront/inventory-sources/tasks" icon="list-check">
    All operations
  </Card>

  <Card title="Get status" href="/v2/storefront/inventory-sources/tasks/get-status" icon="heart-pulse">
    Read the refreshed snapshot
  </Card>

  <Card title="List sync history" href="/v2/storefront/inventory-sources/tasks/list-sync-history" icon="clock-rotate-left">
    Per-run sync drill-down
  </Card>

  <Card title="Test connection" href="/v2/storefront/inventory-sources/tasks/test-connection" icon="plug-circle-check">
    Probe upstream reachability
  </Card>
</CardGroup>