---
title: "Delete an application"
method: DELETE
path: "/v2/apps/{appId}"
tags: ["Lifecycle"]
---

# Delete an application

`DELETE /v2/apps/{appId}`

Removes the application, releases any custom domain, and invalidates the caller's project and workspace caches. The operation is rejected while a snapshot restore is in progress.

Rate limited to 1 request every 3 seconds per user.

## Path parameters

- `appId` string, required

## Response `200`

Application deleted.

- object
  - `status` 'success', required

## Other responses

- `401` — The Authorization header is missing, malformed, or the credentials are not valid.
- `403` — A snapshot restore is currently running for this application.
- `404` — Application not found or the delete operation failed.
- `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)
