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

# Restablecer la contraseña de una base de datos

> Restablece la contraseña de una base de datos concreta a partir de su ID.

**id** `string` *required*

El ID de la base de datos cuya contraseña se va a restablecer.

### Respuesta

**response** `object`

La respuesta con la nueva contraseña.

**Mostrar objeto**

**password** `string`

La nueva contraseña de la base de datos.

**restart\_required** `boolean`

`true` cuando al menos una aplicación de un stack conectado debe reiniciarse para leer la nueva contraseña.

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

Los IDs de esas aplicaciones. Vacío cuando `restart_required` es `false`.

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

### Respuestas de error

**code** `string`

El código de error que indica el motivo del fallo. Valores posibles:

* `AUTH_TOKEN_MISSING`, `API_KEY_INVALID`, `SESSION_REVOKED`: Falta la cabecera `Authorization`, la clave de API no es válida o la sesión del panel fue revocada (`401`).
* `API_KEY_IP_DENIED`, `API_KEY_SCOPE_DENIED`: La clave de API se usa desde una IP que no está en su lista de permitidas, o no tiene el ámbito que requiere la ruta (`403`).
* `ACCESS_DENIED`: El recurso pertenece a otra cuenta, o no tienes el permiso de workspace necesario para él (`403`).
* `DATABASE_NOT_FOUND_OR_FORBIDDEN`: La base de datos indicada no existe o el usuario no tiene acceso.
* `INVALID_PLAN_CONFIG`: La configuración del plan de la base de datos no es válida.
* `FAILED_TO_REBUILD_DATABASE`: No se pudo reconstruir la base de datos con la nueva contraseña.

**message** `string`

Un mensaje descriptivo con más detalles sobre el error.

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