Reinstall dedicated OS
POST/dedicated/rentals/:rental_id/reinstall
Reinstalls the OS and erases server disks; confirmed: true is required. Use os_id from the OS directory. The server must support reinstall and the selected OS; hostname, login, disk layout, IP addresses, owner and paid term are retained. If password and ssh_public_key are both omitted, stored credentials are retained. If either field is supplied, the complete credential set is replaced; the omitted field is not retained. A password, a public SSH key or both may be supplied; an empty set is rejected. cloud_init is not supported here. The command does not charge the balance. After success, read rental details for current credentials; operations and webhooks do not contain them.
Send Idempotency-Key for each new command. After a lost response, retry the original key and unchanged body. HTTP 202 confirms acceptance; read the operation or webhook for the outcome.
Request rules and errors · Lifecycle · Webhooks
Request
Responses
- 202
- 401
- 404
- 409
- 422
- 500
- 503
Accepted for processing
Missing or invalid key, mismatched ID, or inactive integration
Resource not found in this integration
Business or state conflict; inspect detail
Invalid request fields or unsupported parameters
Unexpected server error
Service unavailable or result unconfirmed; for a mutation retain its idempotency key