---
title: "Update Setting"
method: PUT
path: "/api/v1/setting"
tags: ["Setting"]
---

# Update Setting

`PUT /api/v1/setting`

Update a setting item.

## Request body

- UpdateSetting
  - `key` string, required — Key of setting
  - `value` unknown, required

## Response `200`

ok

- Setting
  - `key` string, required — Key of setting
  - `value` unknown, required
  - `hidden` boolean, nullable — Hidden setting or not
  - `restart_service` boolean, required — Restart service or not to apply setting

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `422` — Validation Error

## Changes

> 14 revisions in range; 1 could not be searched.

- **2025-07-21** `69284996eaa6` — 1 breaking
  - response property `hidden` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
- **2025-06-24** `0c09cad5e8d9` — 1 breaking
  - response property `detail/items/loc/items/` list-of-types was widened by adding types `integer` to media type `application/json` of response `422`
- **2022-08-19** `033c8fe2fe57` — 2 warning, 2 info
  - removed the optional property `detail/items/ctx` from the response with the `422` status
  - removed the optional property `detail/items/input` from the response with the `422` status
  - response property `detail/items/loc/items/` list-of-types was narrowed by removing types `integer` from media type `application/json` of response `422`
  - response property `hidden` list-of-types was narrowed by removing types `null` from media type `application/json` of response `200`

[Change history](https://skmtc.dev/openstack/apis/skyline-api/changes/api/v1/setting/put.md)

---

[API](https://skmtc.dev/openstack/apis/skyline-api.md) · [All operations](https://skmtc.dev/openstack/apis/skyline-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/openstack/skyline-api/revisions/4b7c0ce8c025/schema)