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

# Redefinir a senha do banco de dados

> Redefine a senha de um banco de dados específico pelo seu ID.

**id** `string` *required*

O ID do banco de dados cuja senha será redefinida.

### Resposta

**response** `object`

A resposta com a nova senha.

**Mostrar objeto**

**password** `string`

A nova senha do banco de dados.

**restart\_required** `boolean`

`true` quando pelo menos uma aplicação de uma stack conectada precisa reiniciar para ler a nova senha.

**apps\_to\_restart** `string[]`

Os IDs dessas aplicações. Vazio quando `restart_required` é `false`.

```json Response theme={null}
{
  "response": {
    "password": "a1b2c3d4e5f6g7h8",
    "restart_required": false,
    "apps_to_restart": []
  }
}
```

### Respostas de erro

**code** `string`

O código de erro que indica o motivo da falha. Valores possíveis:

* `AUTH_TOKEN_MISSING`, `API_KEY_INVALID`, `SESSION_REVOKED`: O header `Authorization` está ausente, a chave de API é inválida ou a sessão do painel foi revogada (`401`).
* `API_KEY_IP_DENIED`, `API_KEY_SCOPE_DENIED`: A chave de API é usada a partir de um IP fora da sua lista de IPs permitidos, ou não tem o escopo que a rota exige (`403`).
* `ACCESS_DENIED`: O recurso pertence a outra conta, ou você não tem a permissão de workspace para ele (`403`).
* `DATABASE_NOT_FOUND_OR_FORBIDDEN`: O banco de dados informado não existe ou o usuário não tem acesso.
* `INVALID_PLAN_CONFIG`: A configuração do plano do banco de dados é inválida.
* `FAILED_TO_REBUILD_DATABASE`: Falha ao recriar o banco de dados com a nova senha.

**message** `string`

Uma mensagem descritiva com detalhes adicionais sobre o erro.

```json Error Response (403) theme={null}
{
  "code": "ACCESS_DENIED"
}
```

```json Error Response (404) theme={null}
{
  "code": "DATABASE_NOT_FOUND_OR_FORBIDDEN"
}
```

```json Error Response (500) theme={null}
{
  "code": "FAILED_TO_REBUILD_DATABASE"
}
```


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