---
title: "Create a new snapshot of an application"
method: POST
path: "/v2/apps/{appId}/snapshots"
tags: ["Snapshots"]
---

# Create a new snapshot of an application

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

Captures a snapshot of the application and returns a signed download URL valid for 30 days.

The snapshot has a soft deadline: if it finishes within ~90s the response carries the signed URL. Otherwise the route answers `202 SNAPSHOT_PROCESSING` while it keeps generating in the background — expected for large apps, not a failure. Poll the snapshot listing (`GET /v2/apps/:appId/snapshots`) ~2min later instead of re-posting.

Rate limits: 1 snapshot per 5s per user, 1 snapshot per 3min per application, and the plan's daily snapshot quota per owner.

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

## Path parameters

- `appId` string, required

## Response `200`

Snapshot created. The `url` is a signed download URL valid for 30 days.

- object
  - `status` 'success', required
  - `response` object, required
    - `url` string, uri, required
    - `key` string, required

## Other responses

- `202` — Snapshot is still generating and will appear in the snapshot listing on its own (typically within ~2min). Expected for large apps, not a failure — confirm completion via `GET /v2/apps/:appId/snapshots` instead of re-posting.
- `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 capture failed.
- `429` — Rate limit hit. `code: KEEP_CALM` covers the short-term limits (1r/5s per user, 1r/3min per app) — clients should back off and retry. `code: DAILY_SNAPSHOTS_LIMIT_REACHED` means the owner consumed the plan's daily quota — clients should surface an upgrade prompt instead of retrying.
- `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)