---
title: "Restore an application snapshot"
method: POST
path: "/v2/apps/{appId}/snapshots/restore"
tags: ["Snapshots"]
---

# Restore an application snapshot

`POST /v2/apps/{appId}/snapshots/restore`

Restores the application to a previous snapshot identified by `snapshotId` (UUID v4) and `versionId` (snapshot version identifier from the snapshot listing).

Rate limits: 1 restore per 60s per user (`snapshot:restore`) and 1 restore per 120s per application (`snapshot:restore:<appId>`).

Requires the workspace Administrator role (or ownership) when called against a workspace-shared application.

## Path parameters

- `appId` string, required

## Request body

- object
  - `snapshotId` string, uuid, required
  - `versionId` string, required

## Response `200`

Restore dispatched.

- object
  - `status` 'success', required

## Other responses

- `400` — One of `snapshotId` or `versionId` is missing or malformed.
- `401` — The Authorization header is missing, malformed, or the credentials are not valid.
- `403` — The workspace member does not have the required permission for this endpoint.
- `404` — Snapshot not found or the restore could not be dispatched.
- `413` — The request body is larger than the maximum allowed size (100MB).
- `429` — The endpoint enforces its own rate limit and the caller hit the cooldown.
- `500` — An unexpected error occurred while processing the request.

---

[API](https://skmtc.dev/squarecloud/apis/square-cloud-api.md) · [All operations](https://skmtc.dev/squarecloud/apis/square-cloud-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/squarecloud/square-cloud-api/revisions/54b7733a6b95/schema)