---
title: "Update deploy config"
method: PATCH
path: "/servers/{server_id}/deploy_config"
tags: ["Servers"]
---

# Update deploy config

`PATCH /servers/{server_id}/deploy_config`

## Path parameters

- `server_id` string, required

## Request body

- object
  - `type` 'deploy_config', required
  - `attributes` object
    - `hostname` string, nullable
    - `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', nullable
    - `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
    - `user_data` string, nullable — User data to configure the server
    - `ssh_keys` string[], nullable
    - `ipxe_url` string, nullable — URL where iPXE script is stored on, necessary for custom image deployments. 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.
    - `bond` boolean, nullable — Set to 'true' to bond the server onto a prefix. Requires 'prefix_id'. Available only when the prefixes feature is enabled for your team.
    - `prefix_id` string, nullable — ID of a customer prefix to bond the server onto. Requires 'bond' to be 'true'. 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. This bond configuration is saved to the deploy config and inherited by future reinstalls until changed. Available only when the prefixes feature is enabled for your team.

## Response `200`

Success

## Other responses

- `403` — Forbidden
- `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/9545f24e8507/schema)