Reset Password
Generate a new root password for a VPS. The new password is returned in the response and should be stored securely.
Request
POST /api/v1/vps/{id}/reset-password
Required scope: vps:write
Path Parameters
| Parameter | Type | Description |
|---|---|---|
id |
string | The VPS ID |
Headers
| Header | Required | Value |
|---|---|---|
Authorization |
Yes | Bearer YOUR_API_KEY |
No request body is required.
Response
{
"data": {
"password": "aB3$kLm9pQr2"
}
}
Response Fields
| Field | Type | Description |
|---|---|---|
password |
string | The newly generated root password |
Errors
| Status | Code | Description |
|---|---|---|
| 404 | NOT_FOUND |
VPS not found or not accessible |
| 502 | PROVIDER_ERROR |
Upstream provider error |
Example
curl -X POST "https://site.quest/api/v1/vps/699cdea2ab57a244bb5273fd/reset-password" \
-H "Authorization: Bearer YOUR_API_KEY"
MCP
This action is also available via the vm_reset_password MCP tool.