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

Note: subscription fields are managed automatically and cannot be patched.

## Request body

- UserSettingsUpdate — User settings update request - allows partial updates. Note: stripe_customer_id and status are not patchable. trial_expires can only be set once (to start trial).
  - `subscription` TrialUpdate — Trial update - only trial_expires can be set, and only if currently null.
    - `trial_expires` integer, nullable
  - `pinned_workspaces` string[], nullable
  - `tableviews` TableView[], nullable
    - `workspace` string, required
    - `name` string, required
    - `columns` string[], required
  - `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
  - `hide_online_status` boolean, nullable
  - `muted_users` string[], nullable

## Response `204`

Successful Response

## Other responses

- `422` — Validation Error

## Changes

- **2026-01-11** `c3c793024170` — 1 info
  - added the new optional request property `muted_users`
- **2025-12-31** `d14bca97ba86` — 1 info
  - added the new optional request property `hide_online_status`
- **2025-11-09** `dc6f981b30b5` — 1 info
  - added the new optional request property `tableviews`
- **2025-11-03** `d6c3e911a263` — 1 info
  - added the new optional request property `subscription`
- **2025-10-06** `8d3e894e6c0b` — 2 info
  - added the new optional request property `ai_mode`
  - added the new optional request property `show_templates`

[Full 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/1f956ac3d1c1/schema)