> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gleap.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Update settings

> 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.



## OpenAPI

````yaml https://api.gleap.io/api-docs.json put /settings
openapi: 3.0.0
info:
  title: gleap-server
  version: 14.0.0
  contact: {}
servers:
  - url: https://api.gleap.io/v3
security: []
paths:
  /settings:
    put:
      tags:
        - Settings
      summary: Update settings
      description: >-
        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.
      operationId: UpdateSettings
      parameters:
        - in: header
          name: project
          required: true
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateSettingsDto'
      responses:
        '200':
          description: Ok
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SettingsChangeResult'
      security:
        - jwt: []
components:
  schemas:
    UpdateSettingsDto:
      properties:
        changes:
          items:
            $ref: '#/components/schemas/SettingChangeDto'
          type: array
        confirmed:
          type: boolean
          description: >-
            The person said yes to the risky changes listed in
            `needsConfirmation` (SSO, identity verification, deleting …).
      required:
        - changes
      type: object
      additionalProperties: false
    SettingsChangeResult:
      properties:
        changed:
          items:
            properties:
              id:
                type: string
              after: {}
              before: {}
              key:
                type: string
              line:
                type: string
              page:
                type: string
            required:
              - line
              - page
            type: object
          type: array
        refused:
          items:
            properties:
              reason:
                type: string
              change:
                type: string
            required:
              - reason
              - change
            type: object
          type: array
        needsConfirmation:
          items:
            properties:
              why:
                type: string
              change:
                type: string
            required:
              - why
              - change
            type: object
          type: array
          description: >-
            Risky changes not run: the person says yes first (`confirmed: true`,
            or the card in Kai Copilot).
      required:
        - changed
        - refused
      type: object
      additionalProperties: false
    SettingChangeDto:
      description: >-
        One settings change: a field (`key` + `value`), or an item of a page of
        items (`page` + `op`, with `id` / `values`).
      properties:
        key:
          type: string
        value: {}
        page:
          type: string
        op:
          type: string
          enum:
            - create
            - update
            - delete
        id:
          type: string
        values:
          properties: {}
          additionalProperties: {}
          type: object
        site:
          type: string
      type: object
      additionalProperties: false
  securitySchemes:
    jwt:
      type: http
      scheme: bearer
      bearerFormat: JWT

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.