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

**Delete a snapshot.** Delete a snapshot, protected or not. It can no longer be restored. Scope: destructive. Long-running: answers with a task.

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

## When to use it

Delete a snapshot, protected or not. It can no longer be restored.

## Inputs

- `snapshot_id` (integer, ≥ 1, required)

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "snapshot_id": {
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "snapshot_id"
  ],
  "type": "object"
}
```

## Refusals

- `state` (409, message "This snapshot is being copied into a new site or environment. Try again once that has finished."): a new site, a new environment or a restore is being made from it (it may be waiting for its PHP version); delete it once that has finished.
- `deleted`: the site is deleted (in its grace period); restore it with corestack_site_restore_deleted first.
- `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_delete",
  "arguments": {
    "snapshot_id": 9051
  }
}
```

## Prompt

```text
Using the Corefinity MCP server, call corestack_snapshot_delete with snapshot_id 9051. (Delete a snapshot.) Tell me what it returned.
```

## The same task elsewhere

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