Skip to main content
POST
Reinstall a Server

Authorizations

Authorization
string
header
required

API token from Dashboard > Settings > API Tokens.

Path Parameters

server_id
string<uuid>
required

Body

application/json
image_id
string<uuid>
required

Image ID from GET /images, for the server's location and plan.

ssh_key_ids
string<uuid>[]

IDs of your SSH keys to install. Omit for all saved keys (a password if none); send [] for a password. Ignored for Windows images.

Maximum array length: 20
hostname
string

Hostname for the reinstalled OS.

Required string length: 1 - 63
Pattern: ^[a-zA-Z0-9]([a-zA-Z0-9-]*[a-zA-Z0-9])?$

Response

Accepted. Poll GET /servers/{server_id} for status.

server
Server · object
required
password
string | null

Login password for server.login_user, or null when SSH keys are installed. Shown only here and in the email. If support retries the build or Windows password setup fails, follow the email. The old password stops working.