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

# Limpar o cache de borda da aplicação

> Limpe todas as respostas em cache na borda dos domínios de uma aplicação com POST /v2/apps/{app_id}/network/purge_cache, e a próxima requisição vem atualizada.

<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`.

Limpar o cache remove todas as respostas em cache que o Cloudflare está guardando para o domínio principal da aplicação e qualquer domínio personalizado associado, forçando a próxima requisição de cada URL a ser servida diretamente pela aplicação. Use logo após fazer o deploy de uma mudança em assets estáticos ou em uma resposta de API que uma requisição anterior já colocou em cache, quando você não pode esperar o próprio TTL de cache do recurso expirar.

A limpeza em si é assíncrona: o provedor de edge confirma a requisição, mas a propagação por todos os locais de borda não é instantânea. 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`. Para enviar os arquivos alterados primeiro, veja [Enviar commit da aplicação](/pt-br/api-reference/endpoint/apps/commit) ou [Enviar aplicação](/pt-br/api-reference/endpoint/apps/upload).

## 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 |
| - | - | - |
| `KEEP_CALM` | 429 | Mais de 1 limpeza em 60 segundos. |
| `PURGE_CACHE_FAILED` | 500 | A limpeza do cache na borda não pôde ser concluída; tente novamente em instantes. |

## Relacionados

* CLI: [`squarecloud app network purge-cache`](/pt-br/cli-reference/edge-analytics#squarecloud-app-network-purge-cache)
* SDKs: [`api.apps.network.purgeCache()`](/pt-br/sdks/js/network) (JavaScript), [`client.apps.network.purge_cache()`](/pt-br/sdks/py/network) (Python), [`c.Apps.Network.PurgeCache()`](/pt-br/sdks/go/network) (Go)


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