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

# Reset password

> Generate a new password for a database.

Generates a new password for the database. The old password stops working immediately. PgBouncer is reloaded automatically.

## Path parameters

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `id`      | uuid | Database ID |

## Response

```json 200 OK theme={null}
{
  "password": "new-generated-password"
}
```

## Errors

| Status | Code                 | Description                                                                      |
| ------ | -------------------- | -------------------------------------------------------------------------------- |
| 401    | `UNAUTHORIZED`       | Missing or invalid API key                                                       |
| 404    | `DATABASE_NOT_FOUND` | Database doesn't exist, isn't owned by this user, or isn't in scope for this key |
| 500    | `AGENT_ERROR`        | The VPS agent failed to reset the password                                       |

<Warning>
  All active connections using the old password will fail. Update your application's connection string before or immediately after resetting.
</Warning>
