---
title: "Add a new host"
method: POST
path: "/hosts/"
tags: ["Hosts"]
---

# Add a new host

`POST /hosts/`

## Request body

- Host
  - `id` integer
  - `name` string
  - `model` string
  - `host_type` string
  - `build` boolean
  - `validated` boolean
  - `switch_config_applied` boolean
  - `broken` boolean
  - `retired` boolean
  - `can_self_schedule` boolean
  - `last_build` string
  - `cloud_id` integer
  - `default_cloud_id` integer
  - `interfaces` Interface[]
    - `id` integer
    - `name` string
    - `bios_id` string
    - `mac_address` string
    - `switch_ip` string
    - `switch_port` string
    - `speed` integer
    - `vendor` string
    - `pxe_boot` boolean
    - `maintenance` boolean
    - `host_id` integer
  - `disks` Disk[]
    - `disk_id` integer
    - `disk_type` string
    - `size_gb` integer
    - `count` integer
    - `host_id` integer
  - `memory` Memory[]
    - `id` integer
    - `size_gb` integer, required
    - `handle` string, required
    - `host_id` integer, required
  - `processors` Processor[]
    - `id` integer
    - `handle` string
    - `vendor` string
    - `product` string
    - `cores` integer
    - `threads` integer
    - `host_id` integer

## Response `201`

Created

## Changes

- **2025-06-30** `ebdd7b70d1d5` — 1 info
  - added the new optional request property `can_self_schedule`
- **2024-01-29** `73b6d82124fb` — 1 warning
  - removed the request property `can_self_schedule`

[Change history](https://skmtc.dev/quadsproject/apis/quads/changes/hosts/post.md)

---

[API](https://skmtc.dev/quadsproject/apis/quads.md) · [All operations](https://skmtc.dev/quadsproject/apis/quads/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/quadsproject/quads/revisions/a060ee3d649d/schema)