---
title: "corestack_site_live_refresh"
url: https://docs.corefinity.com/mcp/tools/corestack_site_live_refresh
type: tool
last_updated: 2026-11-13
feature: sites
related:
  - https://docs.corefinity.com/api/reference/sites/refresh-site-live-status.md
  - https://docs.corefinity.com/guides/sites/create-and-manage/site-overview.md
---
# corestack_site_live_refresh

**Refresh a site's live status.** Read a site's pod health and live status from its cluster now (at most every 15 seconds), then answer the site as corestack_site_get does. Scope: read.

- Scope: `read`
- Runs as a task: no

## When to use it

Read a site's pod health and live status from its cluster now (at most every 15 seconds), then answer the site as corestack_site_get does.

## Inputs

- `site_id` (integer, ≥ 1, required)

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "site_id": {
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "site_id"
  ],
  "type": "object"
}
```

## Refusals

- `pin_refused`: the environment shown for this site is outside the token's pins. This is checked before reading live status or changing settings, including for existing tokens when a site becomes staging-only. Add the site using the returned link, or address a covered environment by its own `site_id`. The refusal names only the requested row. A successful reply describes the environment admitted at the start of that call, even if the display environment changes while work runs; the next call checks the current display environment again.

- `upstream_unavailable`: the Control Panel answered 502: the cluster, a DNS resolver, Cloudflare, Mailgun, a Git provider, Google, Xero or Cloud Storage did not answer; `details.upstream` names it; retry later.
- The refusals every tool can answer: `invalid_arguments`, `tenant_mismatch`, `scope_required`, `pin_refused`, `rate_limited`, `temporarily_unavailable`, `internal_error` (corestack://guides/how-this-server-works).

## Example

```json
{
  "name": "corestack_site_live_refresh",
  "arguments": {
    "site_id": 4211
  }
}
```

## Prompt

```text
Using the Corefinity MCP server, call corestack_site_live_refresh with site_id 4211. (Refresh a site's live status.) Tell me what it returned.
```

## The same task elsewhere

- Endpoint: [POST /api/corestack/sites/{site}/live](https://docs.corefinity.com/api/reference/sites/refresh-site-live-status.md)
- Guide: [Site overview](https://docs.corefinity.com/guides/sites/create-and-manage/site-overview.md)
