---
title: "corestack_site_cloudflare_purge"
url: https://docs.corefinity.com/mcp/tools/corestack_site_cloudflare_purge
type: tool
last_updated: 2026-11-13
feature: cloudflare
related:
  - https://docs.corefinity.com/api/reference/domains/purge-site-cloudflare-cache.md
  - https://docs.corefinity.com/guides/sites/go-live/cloudflare-for-a-site.md
---
# corestack_site_cloudflare_purge

**Purge a site's Cloudflare cache.** Purge a row's Cloudflare cache: the whole zone (everything: true), or up to 30 addresses on the row's own hosts. Ten purges an hour per site. Scope: write. Long-running: answers with a task.

- Scope: `write`
- Runs as a task: yes

## When to use it

Purge a row's Cloudflare cache: the whole zone (everything: true), or up to 30 addresses on the row's own hosts. Ten purges an hour per site.

## Inputs

- `site_id` (integer, ≥ 1, required)
- `everything` (boolean): true purges the whole zone. Send this or urls, not both.
- `urls` (array of string, up to 2048 characters, 1–30 items): Full addresses (https://…) on the row's own hosts.
- `varnish_first` (boolean): with Varnish on, purge Varnish first (the default) so Cloudflare refills from fresh pages; not counted against the Varnish purges. false purges Cloudflare only.

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "everything": {
      "description": "true purges the whole zone. Send this or urls, not both.",
      "type": "boolean"
    },
    "site_id": {
      "minimum": 1,
      "type": "integer"
    },
    "urls": {
      "description": "Full addresses (https://…) on the row's own hosts.",
      "items": {
        "maxLength": 2048,
        "type": "string"
      },
      "maxItems": 30,
      "minItems": 1,
      "type": "array"
    },
    "varnish_first": {
      "description": "With Varnish on, purge it first (default true).",
      "type": "boolean"
    }
  },
  "required": [
    "site_id"
  ],
  "type": "object"
}
```

## Refusals

- `deleted`: the site is deleted (in its grace period); restore it with corestack_site_restore_deleted first.
- `provisioning`: the site is still being created; wait for corestack_site_provisioning_get to finish.
- `managed_elsewhere` (message: "This site is managed by another control panel"): another control panel manages this site, so use that control panel for it. This is refused before anything else about the site, as in the Control Panel and the API. Nothing was done.
- 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_cloudflare_purge",
  "arguments": {
    "site_id": 4211,
    "urls": [
      "https://example.co.uk/"
    ]
  }
}
```

## Prompt

```text
Using the Corefinity MCP server, call corestack_site_cloudflare_purge with site_id 4211, urls ["https://example.co.uk/"]. (Purge a site's Cloudflare cache.) Tell me what it returned.
```

## The same task elsewhere

- Endpoint: [POST /api/corestack/sites/{site}/cloudflare/purge](https://docs.corefinity.com/api/reference/domains/purge-site-cloudflare-cache.md)
- Guide: [Cloudflare for a site](https://docs.corefinity.com/guides/sites/go-live/cloudflare-for-a-site.md)
