> ## 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 banco de dados

> Exclua um banco de dados de vez e libere seu registro DNS com DELETE /v2/databases/{database_id}. Não há confirmação, então faça um snapshot antes.

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

Remove permanentemente o container do banco de dados e libera seu registro DNS público (`square-cloud-db-<id>.squareweb.app`). Isso é destrutivo e imediato: não há etapa de confirmação, e a URL de conexão para de resolver assim que o registro DNS é liberado.

Se você precisar dos dados depois, tire uma [Snapshot](/pt-br/api-reference/endpoint/databases/snapshots/create) antes de excluir. A requisição é rejeitada enquanto uma restauração de snapshot estiver em andamento no banco de dados. Limite de taxa de 1 exclusão a cada 3 segundos por usuário.

## Parâmetros

<ParamField path="database_id" type="string" placeholder="ID do banco de dados" required>
  O ID do banco de dados.
</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 este banco de dados; aguarde até terminar. |
| `DATABASE_NOT_FOUND` | 404 | O banco de dados não existe ou não pertence a quem fez a chamada. |
| `DELETE_FAILED` | 404 | O cluster rejeitou a operação de exclusão. |

## Relacionados

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


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