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

# Update settings

`PUT /settings`

## Request

- Base URL: `https://api.gleap.io/v3`
- URL: `https://api.gleap.io/v3/settings`
- Auth: HTTP bearer

Change settings with your role's rights. Returns what changed (old → new) and what was refused
and why. Risky changes run only with `confirmed: true`; without it nothing runs and
`needsConfirmation` says what to confirm.

## Headers

- `project` string, required

## Request body

- UpdateSettingsDto
  - `changes` SettingChangeDto[], required
    - `key` string
    - `value` unknown
    - `page` string
    - `op` 'create' | 'update' | 'delete'
    - `id` string
    - `values` object
    - `site` string
  - `confirmed` boolean: The person said yes to the risky changes listed in `needsConfirmation` (SSO, identity verification, deleting …).

## Response `200`

Ok

- SettingsChangeResult
  - `changed` object[], required
    - `id` string
    - `after` unknown
    - `before` unknown
    - `key` string
    - `line` string, required
    - `page` string, required
  - `refused` object[], required
    - `reason` string, required
    - `change` string, required
  - `needsConfirmation` object[]: Risky changes not run: the person says yes first (`confirmed: true`, or the card in Kai Copilot).
    - `why` string, required
    - `change` string, required

## Changes

- **2026-10-29** `9008dc52d09c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/gleap/apis/gleap-server/changes/settings/put.md)

---

[API](https://skmtc.dev/gleap/apis/gleap-server.md) - [All operations](https://skmtc.dev/gleap/apis/gleap-server/llms.txt) - [OpenAPI document](https://skmtc.dev/gleap/apis/gleap-server/revisions/2ec9bd6c1903?raw)