Skip to main content
POST
Reinstall the operating system

Authorizations

Authorization
string
header
required

Session access token (JWT) from POST /v1/auth/login or /v1/auth/refresh. A session satisfies every API scope.

Path Parameters

id
string<uuid>
required

The dedicated server's service id.

Body

application/json

Send profileId (or the legacy osId). One of them is required.

hostname
string
required

Letters, digits, hyphens and dots. Trimmed and lowercased.

Example:

"web-01.example.com"

profileId

An install profile id from GET /profiles.

Required range: x >= 1
osId
string

Legacy alias for profileId.

sshKeyIds
string[]

Saved SSH key ids — yours or the server owner's.

sshKeys
string[]

OpenSSH public keys pasted directly.

rootPassword
string | null

Generated for you when omitted and the profile sets one.

Required string length: 8 - 72
diskLayoutId

One of the profile's disk layouts. Defaults to the profile's default layout.

Response

Reinstall task started.

success
boolean
required
data
object
required