---
title: "Update Preferences"
method: PATCH
path: "/api/me/preferences"
tags: ["me"]
---

# Update Preferences

`PATCH /api/me/preferences`

## Request

- Base URL: `https://app.thinqos.com` (the document declares no server; this is the origin it was published from)
- URL: `https://app.thinqos.com/api/me/preferences`
- Auth: none declared

Patch the current identity's UI preferences.

Only the fields explicitly present in the JSON body are touched.
Passing ``"tts_voice": null`` clears the preference (falls back to the
platform default).

## Headers

- `x-impersonate-identity-id` string, nullable

## Request body

- UpdatePreferencesRequest
  - `tts_voice` string, nullable
  - `tts_voice_backup` string, nullable
  - `timezone` string, nullable
  - `default_mode` string, nullable
  - `notification_style` string, nullable
  - `notification_device` object, nullable
  - `subconscious_agent_mode_expires_at` string, date-time, nullable
  - `subconscious_agent_auto_reply_limit` integer, nullable
  - `subconscious_agent_auto_reply_window_seconds` integer, nullable
  - `dock_page_capture` 'ask' | 'always' | 'never', nullable
  - `disclose_capabilities` boolean, nullable
  - `disclose_reputation` boolean, nullable
  - `request_resolution_updates` boolean, nullable
  - `decision_digest_email` boolean, nullable
  - `appearance_mode` 'system' | 'dark' | 'light', nullable

## Response `200`

Successful Response

- PreferencesResponse
  - `tts_voice` string, nullable, required
  - `tts_voice_backup` string, nullable, required
  - `timezone` string, nullable, required
  - `default_mode` string, required
  - `default_mode_confirmed_at` string, date-time, nullable, required
  - `reply_mode_gate_required` boolean, required
  - `notification_style` string, required
  - `notification_device` object, required
  - `subconscious_agent_mode_expires_at` string, date-time, nullable, required
  - `subconscious_agent_auto_reply_limit` integer, nullable, required
  - `subconscious_agent_auto_reply_window_seconds` integer, nullable, required
  - `dock_page_capture` 'ask' | 'always' | 'never', required
  - `disclose_capabilities` boolean, required
  - `disclose_reputation` boolean, required
  - `request_resolution_updates` boolean, required
  - `decision_digest_email` boolean, required
  - `decision_digest_email_source` 'personal' | 'default', required
  - `appearance_mode` 'system' | 'dark' | 'light', required
  - `appearance_mode_source` 'personal' | 'global', required

## Other responses

- `422`: Validation Error

---

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