---
title: "Update an existing host"
method: PATCH
path: "/hosts/{hostName}/"
tags: ["Hosts"]
---

# Update an existing host

`PATCH /hosts/{hostName}/`

## Path parameters

- `hostName` string, required

## Request body

- HostClean
  - `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

## Response `200`

Host name

- 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

## Other responses

- `default` — Unexpected error

## Changes

- **2025-06-30** `ebdd7b70d1d5` — 2 info
  - added the new optional request property `can_self_schedule`
  - added the optional property `can_self_schedule` to the response with the `200` status
- **2024-01-29** `73b6d82124fb` — 2 warning
  - removed the request property `can_self_schedule`
  - removed the optional property `can_self_schedule` from the response with the `200` status

[Change history](https://skmtc.dev/quadsproject/apis/quads/changes/hosts/:hostName/patch.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)