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

# Update Settings

`PUT /v1/settings`

Update user settings. Only updates fields that are provided.

## Headers

- `authorization` string, nullable

## Request body

- SettingsUpdateRequest — Update user settings request. Only provided fields are updated.
  - `user_id` string, required
  - `role` string, nullable
  - `signals` string, nullable
  - `notifications_enabled` boolean, nullable
  - `notify_email` boolean, nullable
  - `notify_browser` boolean, nullable
  - `notify_trigger` 'refresh' | 'change', nullable

## Response `200`

Successful Response

- SettingsResponse — User settings response.
  - `user_id` string, required
  - `role` string
  - `signals` string
  - `notifications_enabled` boolean
  - `notify_email` boolean
  - `notify_browser` boolean
  - `notify_trigger` 'refresh' | 'change'

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/chonkie/apis/chonkie-api.md) · [All operations](https://skmtc.dev/chonkie/apis/chonkie-api/llms.txt) · [OpenAPI document](https://skmtc.dev/chonkie/apis/chonkie-api/revisions/f40f036f941c?raw)
