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

# Redefinir senha ou certificado do banco de dados

> Troque a senha ou o certificado TLS de um banco de dados com POST /v2/databases/{database_id}/credentials/reset. A nova senha é exibida uma única vez.

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

Rotaciona a senha de acesso ou o certificado TLS de um banco de dados, sem recriá-lo ou alterar a estrutura da sua URL de conexão. Use isso se uma credencial vazou ou como parte de uma política de rotação de rotina.

O banco de dados precisa estar em execução para redefinir qualquer uma das credenciais. Redefinir a `password` retorna a nova senha uma única vez no corpo da resposta; ela não é mostrada novamente, então salve-a imediatamente. Redefinir o `certificate` retorna apenas um sucesso; busque o novo certificado depois via [Obter Certificado](/pt-br/api-reference/endpoint/databases/credentials/get_certificate). Após qualquer uma das redefinições, as conexões de clientes existentes que usam a credencial antiga precisarão se reconectar. Limite de taxa de 1 redefiniçã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>

<ParamField body="reset" type="string" placeholder="password/certificate" required>
  A credencial que você deseja redefinir: "password" ou "certificate".
</ParamField>

## Resposta

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

### Se for redefinição de senha

<ResponseField name="response" type="object">
  O conteúdo da resposta.

  <Expandable title="Alternar objeto">
    <ResponseField name="password" type="string">
      A nova senha gerada.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json theme={"system"}
  {
    "status":"success",
    "response":{
      "password":"f3T1hdskMkchMwK6Hxqinoyb"
    }
  }
  ```
</ResponseExample>

## Erros comuns

| Código | HTTP | Significado |
| - | - | - |
| `INVALID_RESET_TYPE` | 400 | `reset` não era `"password"` nem `"certificate"`. |
| `DATABASE_NOT_RUNNING` | 400 | O banco de dados está parado; inicie-o antes de redefinir as credenciais. |
| `DATABASE_NOT_FOUND` | 404 | O banco de dados não existe ou não pertence a quem fez a chamada. |
| `RESET_FAILED` | 500 | A rotação da credencial foi rejeitada pelo cluster. |

## Relacionados

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


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