---
title: "corestack_restore_create"
url: https://docs.corefinity.com/mcp/tools/corestack_restore_create
type: tool
last_updated: 2026-11-13
feature: restores
related:
  - https://docs.corefinity.com/guides/sites/backups/restore-anywhere.md
---
# corestack_restore_create

**Restore a snapshot.** Restore a snapshot onto its row — everything, the database or the files. Onto the production row it overwrites production. Scope: write. Also needs destructive when the target is production. Long-running: answers with a task.

- Scope: `write`
- Also needs `destructive` when the row is production
- Confirmation: `confirm_domain`
- Runs as a task: yes

## When to use it

Restore a snapshot onto its row — everything, the database or the files. Onto the production row it overwrites production.

The task's answer is the restore, whose `safety_snapshot.id` is the Undo point: restore it with this tool to go back.

## Inputs

- `site_id` (integer, ≥ 1, required): The row the snapshot belongs to.
- `snapshot_id` (integer, ≥ 1, required)
- `mode` (one of `everything`, `database`, `files`, required)
- `safety_snapshot` (boolean, required): Snapshot the row first, so the restore can be undone.
- `confirm_domain` (string, up to 255 characters, required): The site's domain, typed exactly (every row).
- `anonymise` (boolean): Anonymise the restored data (non-production rows only); needs restore anonymising switched on.

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "confirm_domain": {
      "description": "The site's domain, typed exactly (every row).",
      "maxLength": 255,
      "type": "string"
    },
    "mode": {
      "enum": [
        "everything",
        "database",
        "files"
      ],
      "type": "string"
    },
    "safety_snapshot": {
      "description": "Snapshot the row first, so the restore can be undone.",
      "type": "boolean"
    },
    "site_id": {
      "description": "The row the snapshot belongs to.",
      "minimum": 1,
      "type": "integer"
    },
    "snapshot_id": {
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "site_id",
    "snapshot_id",
    "mode",
    "safety_snapshot",
    "confirm_domain"
  ],
  "type": "object"
}
```

## Refusals

- `recovery_required`: the site must first be restored whole from its own snapshot; contact support or restore the whole site.
- `support_only`: unfinished work or a hold by Corefinity's team blocks this; contact support, retrying cannot help.
- `not_started`: the restore could not start (its copy could not be made available or the safety snapshot was refused); it will not advance, so tell the person what the message says.
- `mariadb_change`: the snapshot's database version cannot be restored into this row; restore it into a new environment instead (corestack_environment_create with source `clone` and its `snapshot_id`; while restoring anywhere is switched on, corestack_snapshot_restore_to).
- `snapshot_unavailable`: the snapshot is still being taken or is no longer available; choose another.
- `runtime_unprepared`: the environment needs a platform update before it can take this restore (a snapshot from before an earlier copy or restore of this environment); nothing was changed. Tell the person to contact Corefinity support to update it; retrying cannot help.
- `anonymise_production` (only while `restore_anonymise` is on): production is never anonymised; leave `anonymise` out.
- `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_restore_create",
  "arguments": {
    "site_id": 4211,
    "snapshot_id": 9051,
    "mode": "everything",
    "safety_snapshot": false,
    "confirm_domain": "example.co.uk"
  }
}
```

## Prompt

```text
Using the Corefinity MCP server, call corestack_restore_create with site_id 4211, snapshot_id 9051, mode everything, safety_snapshot false. (Restore a snapshot.) Tell me what it returned.
```

## The same task elsewhere

- Guide: [Restore anywhere](https://docs.corefinity.com/guides/sites/backups/restore-anywhere.md)
