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

**Change a CoreCluster's snapshot frequency.** Set how often a CoreCluster's sites take scheduled snapshots by default. A site can follow it or set its own with corestack_snapshot_frequency_update. Scope: write.

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

## When to use it

Set how often a CoreCluster's sites take scheduled snapshots by default. A site can follow it or set its own with corestack_snapshot_frequency_update.

## Inputs

- `cluster_id` (integer, ≥ 1, required)
- `frequency` (one of `1h`, `2h`, `3h`, `4h`, `6h`, `12h`, `daily`, `weekly`, `monthly`, `off`, required)

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "cluster_id": {
      "minimum": 1,
      "type": "integer"
    },
    "frequency": {
      "enum": [
        "1h",
        "2h",
        "3h",
        "4h",
        "6h",
        "12h",
        "daily",
        "weekly",
        "monthly",
        "off"
      ],
      "type": "string"
    }
  },
  "required": [
    "cluster_id",
    "frequency"
  ],
  "type": "object"
}
```

## Refusals

- `platform_cluster`: this is a platform cluster, where this setting is not yours to change.
- 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": "corecluster_snapshot_settings_update",
  "arguments": {
    "cluster_id": 812,
    "frequency": "1h"
  }
}
```

## Prompt

```text
Using the Corefinity MCP server, call corecluster_snapshot_settings_update with cluster_id 812, frequency 1h. (Change a CoreCluster's snapshot frequency.) Tell me what it returned.
```

## The same task elsewhere

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