> ## 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 um arquivo da aplicação

> Exclua um único arquivo de uma aplicação pelo caminho com DELETE /v2/apps/{app_id}/files. Vale na hora, sem reiniciar a aplicação nem fazer um novo deploy.

<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) `files:write`.

Excluir arquivo remove um único arquivo de uma aplicação em execução pelo caminho, sem afetar o restante da árvore de arquivos ou reiniciar o processo. Use-o para limpar arquivos gerados, logs antigos ou uploads perdidos sem precisar reimplantar.

A exclusão acontece diretamente no armazenamento da aplicação no nó do cluster, então ela tem efeito imediato; não há como desfazer, exceto restaurando a partir de um [snapshot](/pt-br/api-reference/endpoint/apps/snapshots/restore) anterior. Para remover uma aplicação inteira em vez de um arquivo, veja [Excluir aplicação](/pt-br/api-reference/endpoint/apps/delete). Para renomear ou mover um arquivo em vez de excluí-lo, use [Mover arquivo](/pt-br/api-reference/endpoint/apps/filemanager/patch).

Em aplicações compartilhadas em workspace, quem chama precisa da [função](/pt-br/api-reference/endpoint/workspace/members/invite#funções) `maintain` ou `admin`. Membros sem a permissão de arquivos restritos não podem excluir arquivos da lista de exclusão (como `.env` ou `.env.production`); a requisição é rejeitada primeiro com `PERMISSION_DENIED`.

## 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>

<ParamField body="path" type="string" placeholder="Caminho do arquivo" required>
  O caminho do arquivo a ser excluído, com até 256 caracteres.
</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 |
| - | - | - |
| `INVALID_PATH` | 400 | O campo `path` falhou na validação (travessia, caracteres inválidos ou mais de 256 caracteres). |
| `DELETE_FAILED` | 400 | O cluster não conseguiu excluir o arquivo. |
| `PERMISSION_DENIED` | 403 | Quem chama não tem a permissão de workspace para excluir um arquivo restrito. |

## Relacionados

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


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