---
title: "Update cluster settings"
method: PUT
path: "/cluster-settings"
tags: ["cluster-settings"]
---

# Update cluster settings

`PUT /cluster-settings`

## Request body

- ClusterSettings
  - `hostDirPolicies` object[] — If not empty, allows instantiating VMs with `hostDirs` that match the policies listed in this array.
    - `pathPrefix` string
    - `ro` boolean
  - `schedulerProfile` 'optimize-utilization' | 'distribute-load' — Scheduler profile to use. Possible values: * `optimize-utilization` — when scheduling a pending VM to a worker, pick the busiest worker that can fit a VM first, falling back to less busier workers (this is the default behavior when no explicit scheduler profile is set) * `distribute-load` — when scheduling a pending VM to a worker, pick the least occupied worker that can fit a VM first, falling back to more busier workers

## Response `200`

Cluster settings were successfully updated

- ClusterSettings
  - `hostDirPolicies` object[] — If not empty, allows instantiating VMs with `hostDirs` that match the policies listed in this array.
    - `pathPrefix` string
    - `ro` boolean
  - `schedulerProfile` 'optimize-utilization' | 'distribute-load' — Scheduler profile to use. Possible values: * `optimize-utilization` — when scheduling a pending VM to a worker, pick the busiest worker that can fit a VM first, falling back to less busier workers (this is the default behavior when no explicit scheduler profile is set) * `distribute-load` — when scheduling a pending VM to a worker, pick the least occupied worker that can fit a VM first, falling back to more busier workers

## Changes

- **2025-11-11** `cd959a44c8d1` — 1 breaking, 2 info
  - added required request body
  - added the optional property `schedulerProfile` to the response with the `200` status
  - the `hostDirPolicies` response's property default value `` was added for the status `200`
- **2023-10-09** `e0632c7e52ea` — 1 breaking, 1 info
  - the response's body type/format changed from ``/`` to `object`/`` for status `200`
  - added the optional property `hostDirPolicies` to the response with the `200` status
- **2023-07-04** `df290e3bee7e` — 1 info
  - endpoint added
- **2023-01-26** `4b9547159dde` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/openai/apis/orchard/changes/cluster-settings/put.md)

---

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