---
title: "Run Server Reinstall"
method: POST
path: "/servers/{server_id}/reinstall"
tags: ["Servers"]
---

# Run Server Reinstall

`POST /servers/{server_id}/reinstall`

## Path parameters

- `server_id` string, required

## Request body

- object
  - `data` object, required
    - `type` 'reinstalls', required
    - `attributes` object
      - `operating_system` 'centos_7_4_x64' | 'centos_8_x64' | 'debian_10' | 'debian_11' | 'debian_12' | 'ipxe' | 'rhel8' | 'rockylinux_8' | 'ubuntu22_ml_in_a_box' | 'ubuntu24_ml_in_a_box' | 'ubuntu_20_04_x64_lts' | 'ubuntu_22_04_x64_lts' | 'ubuntu_24_04_x64_lts' | 'windows_2022_std' | 'windows_server_2019_std_v1' — The OS selected for the reinstall process
      - `hostname` string — The server hostname to set upon reinstall
      - `ssh_keys` string[], nullable — SSH Key IDs to set upon reinstall
      - `user_data` string, nullable — User data ID to set upon reinstall
      - `raid` 'raid-0' | 'raid-1', nullable — RAID mode for the server. Set to 'raid-0' for RAID 0, 'raid-1' for RAID 1, or omit/null for no RAID configuration
      - `disk_layout` object[], nullable
        - `count` integer, required
        - `role` 'os' | 'storage' | 'raw', required
        - `raid_level` 'raid-0' | 'raid-1', nullable
        - `filesystem` 'ext4' | 'xfs', nullable
        - `mount_point` string, nullable
      - `ipxe` string, nullable — URL where iPXE script is stored on, OR the iPXE script encoded in base64. This attribute is required when operating system iPXE is selected.
      - `persistent_netboot` boolean — Keep network boot enabled so the server iPXE-boots on every reboot instead of booting from disk. Only supported with the 'ipxe' operating system.
      - `prefix_id` string, nullable — ID of a customer prefix to bond this server to during the reinstall. The prefix must belong to the same project and be in the same location as the server, and must have at least one free IP address. Applies to this reinstall only; omit it to leave any existing bond unchanged.

## Response `201`

Created

## Other responses

- `403` — Forbidden
- `404` — Not Found
- `422` — Unprocessable Entity

---

[API](https://skmtc.net/latitude/apis/latitude-sh-api.md) · [All operations](https://skmtc.net/latitude/apis/latitude-sh-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/latitude/latitude-sh-api/revisions/7302d79e39bb/schema)