---
title: "Reinstall · API | Rdp.Vision"
description: "POST /servers/{id}/reinstall: Installs a fresh operating system with a new password. Erases everything on the server. Follow the progress with Get a server."
url: https://rdp.vision/docs/api/servers/reinstall
---

Open in AI

[ChatGPT](https://chatgpt.com/?q=Read%20https%3A%2F%2Frdp.vision%2Fdocs%2Fapi%2Fservers%2Freinstall.md%20and%20help%20me%20use%20the%20Rdp.Vision%20API.)[Claude](https://claude.ai/new?q=Read%20https%3A%2F%2Frdp.vision%2Fdocs%2Fapi%2Fservers%2Freinstall.md%20and%20help%20me%20use%20the%20Rdp.Vision%20API.)

Servers

# Reinstall

Installs a fresh operating system with a new password. Erases everything on the server. Follow the progress with Get a server.

POST`/servers/{id}/reinstall`

This can’t be undone. Give this scope only to keys that need it.

## Authorization

`Authorization`header required

`Bearer rv_…`, a key with the `reinstall` scope. [About keys](https://rdp.vision/docs/api/authentication)

## Path parameters

`id`string (uuid) required

The server id from List servers.

## Body

application/json

`distro_id`integer required

From List operating systems; must run on the server’s product.

## Status codes

- 200 | Success.
- 401 | No key, a wrong key, or a revoked or expired one.
- 429 | More than 120 requests a minute with one key, or too many wrong keys from one address.

Request

curl -X POST "https://rdp.vision/api/v1/servers/3f6c2a8e-91d4-4b7a-a5e2-7c0d9b1f4e36/reinstall" \\
  -H "Authorization: Bearer $RDPVISION\_KEY" \\
  -H "Content-Type: application/json" \\
  -d '{"distro\_id":2}'

Response

{
  "success": true
}