---
title: "Update System Settings"
method: PUT
path: "/api/v1/admin/settings"
tags: ["System Settings"]
---

# Update System Settings

`PUT /api/v1/admin/settings`

Partial update: keys absent from `values` stay untouched; null or empty string reverts a key to its environment/default fallback. Changes take effect immediately without a restart.

## Request body

- object
  - `values` object, required

## Response `200`

Updated settings catalog

- object — Updated settings catalog
  - `success` boolean, required
  - `data` object, required
    - `settings` object[], required
      - `key` string, required
      - `group` string, required
      - `kind` 'string' | 'number' | 'boolean', required
      - `secret` boolean, required
      - `source` 'database' | 'environment' | 'default', required
      - `value` unknown
      - `isSet` boolean, required

## Other responses

- `400` — Unknown setting key or invalid value
- `401` — Not authenticated
- `403` — Insufficient permissions

---

[API](https://skmtc.dev/newapi/apis/qn-platform-api.md) · [All operations](https://skmtc.dev/newapi/apis/qn-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/newapi/qn-platform-api/revisions/d61f11e363ff/schema)