---
title: "corestack_snapshot_frequency_update"
url: https://docs.corefinity.com/mcp/tools/corestack_snapshot_frequency_update
type: tool
last_updated: 2026-11-13
feature: snapshots
related:
  - https://docs.corefinity.com/api/reference/backups/update-site-snapshot-frequency.md
  - https://docs.corefinity.com/guides/sites/backups/snapshots.md
---
# corestack_snapshot_frequency_update

**Change a site's snapshot frequency.** Set how often one row takes scheduled snapshots, or null to follow its default: its CoreCluster's, or for a CoreStack site its package's. Scope: write.

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

## When to use it

Set how often one row takes scheduled snapshots, or null to follow its default: its CoreCluster's, or for a CoreStack site its package's.

The answer is the row's snapshot settings, as `settings` in corestack_snapshot_list (a grant pinned to one environment gets the site's usage figures as `null` there too). The next scheduled snapshot moves to the first slot of the new frequency.

## Inputs

- `site_id` (integer, ≥ 1, required)
- `frequency` (one of `1h`, `2h`, `3h`, `4h`, `6h`, `12h`, `daily`, `weekly`, `monthly`, `off`, required): A frequency, or null to follow the default (the CoreCluster's, or a CoreStack site's package).

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "frequency": {
      "description": "A frequency, or null to follow the default (the CoreCluster's, or a CoreStack site's package).",
      "enum": [
        "1h",
        "2h",
        "3h",
        "4h",
        "6h",
        "12h",
        "daily",
        "weekly",
        "monthly",
        "off"
      ],
      "type": [
        "string",
        "null"
      ]
    },
    "site_id": {
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "site_id",
    "frequency"
  ],
  "type": "object"
}
```

## Refusals

- `removed`: the row has been removed.
- `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_snapshot_frequency_update",
  "arguments": {
    "site_id": 4211,
    "frequency": "1h"
  }
}
```

## Prompt

```text
Using the Corefinity MCP server, call corestack_snapshot_frequency_update with site_id 4211, frequency 1h. (Change a site's snapshot frequency.) Tell me what it returned.
```

## The same task elsewhere

- Endpoint: [PUT /api/corestack/sites/{site}/snapshot-frequency](https://docs.corefinity.com/api/reference/backups/update-site-snapshot-frequency.md)
- Guide: [Backups](https://docs.corefinity.com/guides/sites/backups/snapshots.md)
