---
title: "restore_snapshot"
description: "Generated reference for the management action restore_snapshot: its description, access metadata, payload contract, and registration status."
slug: /reference/actions/restore-snapshot
order: 35
visibility: public
redirects_from: []
---

# restore\_snapshot

Generated automatically from the [published contract sources](/cloud/reference/about/#contract-sources).

This action is not implemented. Its reserved HTTP route is `POST https://tzcloud.turnzero.ai/v1/restore_snapshot`, which returns 501 `not_yet_provisioned`. It is not listed as an MCP tool.

**Build metadata:** Not registered in this build. Registration describes the default dispatcher in this build. It does not guarantee that a caller has the required credential or grant, that a tool is listed for that connection, or that the required service is configured.

## Contract description

Restore an environment's database from a snapshot\. No build serves this action yet: your tool list leaves it out, and the management route returns 501 `not_yet_provisioned`\.

## Access and action metadata

```json
{
  "name": "restore_snapshot",
  "resource": "environment",
  "tier": "destructive",
  "surface": "tzcloud",
  "addresses": [],
  "product": "cloud",
  "summary": "Restore a snapshot, discarding state written since.",
  "annotations": {
    "readOnlyHint": false,
    "destructiveHint": true,
    "openWorldHint": false
  }
}
```

## MCP catalog entry

```json
{
  "name": "restore_snapshot",
  "title": "Restore database snapshot",
  "tier": "destructive",
  "scenario": "CHI-L0-09",
  "summary": "Restore an environment's database from a snapshot. No build serves this action yet: your tool list leaves it out, and the management route returns 501 `not_yet_provisioned`.",
  "owners": [
    "PLD-L0-57"
  ]
}
```

No payload contract is indexed for this action. No request or response shape is inferred here.

## Shared contracts

- [Refusals](/cloud/reference/refusals/): every refusal, by surface, with its cause and its remedy
- [schemas/wire\_error\.schema\.json](/cloud/reference/sources/schemas/wire-error-schema/)
- [schemas/wire\_errors\.json](/cloud/reference/sources/schemas/wire-errors/)
- [schemas/action\_payloads\.json](/cloud/reference/sources/schemas/action-payloads/) (includes shared shapes)
- [management\_api\_contract\.md](/cloud/reference/sources/management-api-contract/)
