v1

latestOpenAPI 3.0.32026-07-1415028.7 KB

Resources

Reset Server

post/v1/servers/{serverId}/reset

Path parameters

serverIdstring required

The server identifier.

Headers

x-rd-keystring required

Example:{{key}}

Request body

hostnamestring

Hostname assigned to the server. This value is applied to the operating system during provisioning. If not provided, the previous hostname will be used. If using Custom iPXE, this will serve as a human-readable identifier for the server.

osIdnumber required

Identifier of the operating system template to install on the server during provisioning. The selected OS determines the base image applied at deployment time.

raidnumber

RAID configuration to apply to the server’s storage during provisioning.

This option is only available on plans that support hardware RAID.

sshKeyIdstring

This is an SSH key passed to cloud-init on provision.

customIpxestring

Raw iPXE script content to execute during provisioning.

This value is only used when the selected OS ID is Custom iPXE. When provided, the provisioning environment will execute the supplied script directly within iPXE instead of chainloading a URL.

customIpxeUrlstring

A fully qualified URL pointing to an iPXE script to chainload during provisioning.

This value is only used when the selected OS ID is Custom iPXE. When set, the provisioning environment will boot into iPXE and execute:

chain --autofree <customIpxeUrl>

alwaysIpxeboolean

When true, the server will boot into iPXE on every reboot (persistent network boot) rather than booting from the installed OS.

Example request

{
  "hostname": "fed",
  "osId": 54,
  "raid": -1,
  "sshKeyId": "eb91d60b-08d4-408e-9c0a-331f800cb36a"
}

Response

successboolean required

messagestring required