> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Excluir aplicação

> Exclua uma aplicação de vez com DELETE /v2/apps/{app_id}. Libera o domínio personalizado, não pode ser desfeito e é recusado durante uma restauração.

<ParamField header="Authorization" type="string" placeholder="Chave da API" required>
  A chave da API para sua conta. Você pode encontrá-la nas [configurações da conta](https://squarecloud.app/pt-br/account/security).
</ParamField>

Requer uma chave de API com o [escopo](/pt-br/api-reference/authentication#escopos) `apps:write`.

Excluir uma aplicação a remove permanentemente do cluster em que ela roda, libera qualquer domínio personalizado anexado a ela (a menos que outra das suas aplicações ainda sirva esse hostname) e invalida suas listagens de projetos e workspaces em cache, para que a mudança apareça imediatamente no dashboard e na API.

Essa ação não pode ser desfeita pela API. Se você só quer liberar recursos temporariamente, use [Parar aplicação](/pt-br/api-reference/endpoint/apps/stop), ou tire um [snapshot](/pt-br/api-reference/endpoint/apps/snapshots/create) antes, para poder restaurar a aplicação depois.

A requisição é rejeitada enquanto já houver uma restauração de snapshot em andamento para a mesma aplicação. Possui limite de taxa de 1 requisição a cada 3 segundos por usuário.

## Parâmetros

<ParamField path="app_id" type="string" placeholder="ID da Aplicação" required>
  O ID da aplicação. Você pode encontrá-lo na URL da sua aplicação no dashboard.
</ParamField>

## Resposta

<ResponseField name="status" type="string">
  Indica se a chamada foi bem-sucedida: `success` se foi, `error` se não.
</ResponseField>

<ResponseExample>
  ```json theme={"system"}
  {
      "status": "success"
  }
  ```
</ResponseExample>

## Erros comuns

| Código | HTTP | Significado |
| - | - | - |
| `RESTORE_IN_PROGRESS` | 403 | Uma restauração de snapshot está em andamento para esta aplicação; aguarde ela terminar antes de excluir. |
| `APP_NOT_FOUND` | 404 | A aplicação não existe ou não pertence a quem fez a requisição. |
| `DELETE_FAILED` | 404 | O cluster rejeitou a operação de exclusão. |

## Relacionados

* CLI: [`squarecloud app delete`](/pt-br/cli-reference/apps#squarecloud-app-delete)
* SDKs: [`api.apps.delete()`](/pt-br/sdks/js/managing_application) (JavaScript), [`client.apps.delete()`](/pt-br/sdks/py/managing_application) (Python), [`c.Apps.Delete()`](/pt-br/sdks/go/managing_application) (Go)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.