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

# Rotacionar senha do banco

> Rotaciona a senha do banco vinculado à primeira aplicação retornada para a conta.

Rotaciona a senha do banco vinculado à primeira aplicação retornada para a conta. Atualize os segredos das aplicações que usam esse banco.

## Parâmetros

**id** `string` *required*

ID do banco retornado na [listagem](https://docs.dscloud.pt/database-reference/endpoint/db/managing/list.md).

## Resposta

HTTP 200. `response` é um objeto. Seus campos também podem aparecer no nível superior por compatibilidade.

```json HTTP 200 theme={null}
{
  "status": "success",
  "code": "SUCCESS",
  "response": {
    "id": "db-exemplo",
    "new_password": "SEGREDO"
  },
  "id": "db-exemplo",
  "new_password": "SEGREDO",
  "success": true
}
```

## Erros desta operação

| HTTP | Código | Quando ocorre |
| - | - | - |
| 400 | `NO_SERVER_FOUND` | Nenhuma aplicação disponível. |
| 500 | `DATABASE_ROTATE_FAILED` | Falha ao rotacionar a senha. |

```bash cURL theme={null}
: "${DSCLOUD_API_BASE_URL:=https://api.dscloud.pt/v3}"
curl --proto '=https' --fail-with-body --request POST \
  --header "Authorization: ${DSCLOUD_API_KEY:?Defina DSCLOUD_API_KEY}" \
  "${DSCLOUD_API_BASE_URL%/}/databases/${DSCLOUD_DATABASE_ID:?Defina DSCLOUD_DATABASE_ID}/rotate"
```


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