---
title: "PATCH /api/user/preferences/"
method: PATCH
path: "/api/user/preferences/"
tags: ["User"]
---

# PATCH /api/user/preferences/

`PATCH /api/user/preferences/`

## Request

- Base URL: `https://api.baserow.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.baserow.io/api/user/preferences/`
- Auth: HTTP bearer

Changes one or more preferences of the authenticated user, such as the default sort order of a listing page. Preferences that are not provided keep their value. Responds with all preferences.

## Request body

- PatchedUpdateUserPreferences: The same fields, all optional, so a PATCH can change any subset.
  - `all_workspaces_sort_by` 'created' | 'last_viewed' | 'name_asc' | 'name_desc': * `created` - created * `last_viewed` - last_viewed * `name_asc` - name_asc * `name_desc` - name_desc
  - `all_workspaces_view_mode` 'expanded' | 'compact': * `expanded` - expanded * `compact` - compact
  - `recently_viewed_view_mode` 'table' | 'cards': * `table` - table * `cards` - cards
  - `workspace_recently_viewed_view_mode` 'table' | 'cards': * `table` - table * `cards` - cards

## Response `200`

- UserPreferences: One field per registered user preference type; every value is always present in a response, validated by the type that owns it.
  - `all_workspaces_sort_by` 'created' | 'last_viewed' | 'name_asc' | 'name_desc', required: * `created` - created * `last_viewed` - last_viewed * `name_asc` - name_asc * `name_desc` - name_desc
  - `all_workspaces_view_mode` 'expanded' | 'compact', required: * `expanded` - expanded * `compact` - compact
  - `recently_viewed_view_mode` 'table' | 'cards', required: * `table` - table * `cards` - cards
  - `workspace_recently_viewed_view_mode` 'table' | 'cards', required: * `table` - table * `cards` - cards

## Other responses

- `400`

## Changes

- **2026-09-30** `e81714236040`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/baserow/apis/baserow-api-spec/changes/api/user/preferences/patch.md)

---

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