# reset_vps_root_password

> Reset the root password of a VPS the account owns — rewritten into the guest image offline, which forces downtime (a stop/start) — and does not reset on this call: it…

- Tier: D
- Required scope: write:vps
- Annotations: destructiveHint, idempotentHint
- Docs: https://api.inleed.com/tools/reset-vps-root-password

## Description

Reset the root password of a VPS the account owns — rewritten into the guest image offline, which forces downtime (a stop/start) — and does not reset on this call: it confirms ownership, then returns `{status:"confirmation_required", confirmationUrl, …}`. Show the human the `confirmationUrl` to approve in the client area; do not approve it yourself, then poll `get_pending_action`. You supply `new_password`; it is never echoed back — the customer keeps the value they chose. This is not the vnc console credential (`get_vps_console`).

## Input schema

- `input` — string (required). The VPS whose root password to reset — an Inleed service id from list_vps (data[].serviceId), or a domain/URL that resolves to the VPS service. Resolved to the owning account automatically.
- `new_password` — string (required). It is held encrypted and never shown again, so keep the value.
- `attempt_key` — string. An idempotency key you choose. Reusing it within an hour returns the same held reset.

## Example call

```json
{
  "name": "reset_vps_root_password",
  "arguments": {
    "input": "example.se",
    "new_password": "example.se"
  }
}
```