---
title: "Create server"
method: POST
path: "/servers"
tags: ["Servers"]
---

# Create server

`POST /servers`

## Request body

- object
  - `data` object
    - `type` 'servers', required
    - `attributes` object
      - `project` string, required — The project (ID or Slug) to deploy the server
      - `plan` 'c2-large-x86' | 'c2-medium-x86' | 'c2-small-x86' | 'c3-large-x86' | 'c3-medium-x86' | 'c3-small-x86' | 'c3-xlarge-x86' | 'g3-gh200' | 'g3-large-x86' | 'g3-medium-x86' | 'g3-small-x86' | 'g3-xlarge-x86' | 'g4-rtx6kpro-large' | 'm3-large-x86' | 'm4-metal-large' | 'm4-metal-small' | 'rs4-metal-xlarge' | 's2-small-x86' | 's3-large-x86', required — The plan slug to choose server from, defining the specs the server will have
      - `site` 'ASH' | 'BUE' | 'CHI' | 'DAL' | 'FRA' | 'LAX' | 'LON' | 'MEX' | 'MEX2' | 'MIA' | 'MIA2' | 'NYC' | 'SAO' | 'SAO2' | 'SGP' | 'SYD' | 'TYO' | 'TYO2', required — The site slug to deploy the server
      - `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', required — The operating system slug for the new server
      - `hostname` string, required — The server hostname
      - `ssh_keys` string[], nullable — SSH Keys to set on the server
      - `user_data` string, nullable — User data ID to set on the server. This is a custom script that will run after the deploy
      - `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 iPXE is selected as operating system.
      - `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.
      - `billing` 'hourly' | 'monthly' | 'yearly', nullable — The server billing type. Accepts `hourly` and `monthly` for on demand projects and `yearly` for reserved projects.

## Response `201`

Created

---

[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/versions/7302d79e39bb/schema)