---
title: "Update User Settings"
method: PATCH
path: "/api/user/settings"
tags: ["user"]
---

# Update User Settings

`PATCH /api/user/settings`

Update user's settings (merge with existing).

## Request body

- UserSettingsUpdate — User settings update request - allows partial updates.
  - `pinned_workspaces` string[], nullable
  - `show_document_navigator` boolean, nullable
  - `show_thread_visualization` boolean, nullable
  - `show_smart_search` boolean, nullable
  - `show_security_settings` boolean, nullable
  - `show_invite_tab` boolean, nullable
  - `show_help_page` boolean, nullable
  - `show_templates` boolean, nullable
  - `ai_mode` string, nullable

## Response `204`

Successful Response

## Other responses

- `422` — Validation Error

## Changes

- **2025-10-06** `8d3e894e6c0b` — 2 info
  - added the new optional request property `ai_mode`
  - added the new optional request property `show_templates`
- **2025-08-19** `5287337ab0fe` — 1 warning, 6 info
  - removed the request property `active_config`
  - added the new optional request property `show_document_navigator`
  - added the new optional request property `show_help_page`
  - added the new optional request property `show_invite_tab`
  - …3 more
- **2025-08-06** `43c12480eb1b` — 1 info
  - added the new optional request property `active_config`

[Change history](https://skmtc.dev/arbicity/apis/arbi/changes/api/user/settings/patch.md)

---

[API](https://skmtc.dev/arbicity/apis/arbi.md) · [All operations](https://skmtc.dev/arbicity/apis/arbi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/arbicity/arbi/revisions/8d3e894e6c0b/schema)