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

**Take a snapshot.** Take a manual snapshot of a row now — its files and database — to restore later. Scope: write. Long-running: answers with a task.

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

## When to use it

Take a manual snapshot of a row now — its files and database — to restore later.

## Inputs

- `site_id` (integer, ≥ 1, required)
- `note` (string, up to 140 characters): A note shown beside the snapshot.

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "note": {
      "description": "A note shown beside the snapshot.",
      "maxLength": 140,
      "type": "string"
    },
    "site_id": {
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "site_id"
  ],
  "type": "object"
}
```

## Refusals

- `restoring`: a restore is running on the row; wait for it.
- `in_flight`: a snapshot or restore of this row is already in progress; wait for it.
- `mariadb_change`: a MariaDB version change is in progress; wait for it to finish.
- `disabled`: snapshots are switched off for this row.
- `manual_cap`: the row has taken its 20 one-off snapshots for this hour; try again later. Deleting a snapshot does not free a place.
- `google_cap`: a row on a Google disk has reached Google's limit of 6 snapshots of the disk an hour, scheduled ones included, so it can take at most 6 one-off snapshots an hour; try again later.
- `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_create",
  "arguments": {
    "site_id": 4211,
    "note": "Before the import"
  }
}
```

## Prompt

```text
Using the Corefinity MCP server, call corestack_snapshot_create with site_id 4211, note Before the import. (Take a snapshot.) Tell me what it returned.
```

## The same task elsewhere

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