GlobalPatch

One patch of [GlobalSettings]. Absent fields are left alone.

Type object

Shape

Field	Type	Description
theme	ThemeChoice or null
icon_pack	IconPackChoice or null
caret_color	CaretColorChoice or null
caret_width	CaretWidthChoice or null
caret_height	CaretHeightChoice or null
ui_font	FontSetting or null
body_font	FontSetting or null
headings_font	FontSetting or null
code_font	FontSetting or null
chat_font	FontSetting or null	`follow_default` puts the chat back on the app font.
document_text_size	DocTextSizeSetting or null
base_color_light	Nullable_RgbColor	`#rrggbb` sets the light theme's base color; `null` puts the theme's own back. Settings offers that as its first swatch, so unlike the text size this choice can be taken back - which is why this is a [`Field`] and not an `Option`.
base_color_dark	Nullable_RgbColor	The same for the dark theme.
accent_color_light	Nullable_RgbColor	`#rrggbb` sets the light theme's accent; `null` puts the theme's own back, which Settings offers as the row's first swatch.
accent_color_dark	Nullable_RgbColor	The same for the dark theme.
density	DensityChoice or null
scroll_speed	ScrollSpeedChoice or null
zoom	number (float) or null
default_view_mode	ViewModeChoice or null
default_canvas_background	CanvasBackground or null
pinned_show_title	boolean or null
tabs_per_workspace	boolean or null
popout_close	PopoutCloseChoice or null
emoji_skin_tone	string or null
dictation_gesture	DictationGesture or null
dictation_language	LanguageChoice or null
dictation_tier	DictationTier or null
dictation_input	DictationInput or null
spellcheck_enabled	boolean or null
spellcheck_language	LanguageChoice or null
favorite_models	array of FavoriteModel or null	The whole favorites list, written whole on every star: an empty list clears them. Absent leaves the stored list alone.
close_behavior	CloseBehaviorChoice or null
global_shortcut	GlobalShortcut or null
global_dictation_enabled	boolean or null
global_dictation_shortcut	DictationShortcut or null
start_on_login	boolean or null
reminder_start_on_login_explained	boolean or null
automatic_update_checks	boolean or null
delegate_temporary_root	Nullable_string	`null` puts it back to the platform's temporary directory, which is why this is a [`Field`] and not an `Option`: absent, null and a path are three different instructions and only two of them fit in an `Option`.
recording	RecordingPrefs or null	The recorder's prefill, written whole on every Record. Absent leaves the stored set alone.
disabled_agents	array of string or null	The whole off list, written whole on every switch: an empty list is Restore defaults. Absent leaves the stored list alone.
default_permission	AgentPermission or null	The permission a new chat with a supported agent starts in.
default_permission_other	AgentPermission or null	The permission a new chat with any other agent starts in: Manual or Yolo - an agent with no auto mode has no Auto to start in.
default_agent	Nullable_string	The agent a new chat starts with; `null` is Auto.
agent_order	array of string or null	The whole order, written whole on every move: an empty list is the built-in order. Absent leaves the stored order alone.

Example

{
  "theme": "system",
  "icon_pack": "phosphor",
  "caret_color": "default",
  "caret_width": "thin",
  "caret_height": "short",
  "ui_font": "follow_default",
  "body_font": "follow_default",
  "headings_font": "follow_default",
  "code_font": "follow_default",
  "chat_font": "follow_default",
  "document_text_size": "follow_default",
  "base_color_light": {},
  "base_color_dark": {},
  "accent_color_light": {},
  "accent_color_dark": {},
  "density": "normal",
  "scroll_speed": "1x",
  "zoom": 0,
  "default_view_mode": "page",
  "default_canvas_background": "auto",
  "pinned_show_title": false,
  "tabs_per_workspace": false,
  "popout_close": "ask",
  "emoji_skin_tone": "string",
  "dictation_gesture": "push_to_talk",
  "dictation_language": "automatic",
  "dictation_tier": "compact",
  "dictation_input": "system_default",
  "spellcheck_enabled": false,
  "spellcheck_language": "automatic",
  "favorite_models": [
    {
      "agent": "string",
      "model": "string"
    }
  ],
  "close_behavior": "ask",
  "global_shortcut": "string",
  "global_dictation_enabled": false,
  "global_dictation_shortcut": "string",
  "start_on_login": false,
  "reminder_start_on_login_explained": false,
  "automatic_update_checks": false,
  "delegate_temporary_root": {},
  "recording": {
    "preset": "",
    "custom_width": 0,
    "custom_height": 0,
    "frame_rate": 0,
    "cursor": false,
    "folder": "string"
  },
  "disabled_agents": [
    "string"
  ],
  "default_permission": "manual",
  "default_permission_other": "manual",
  "default_agent": {},
  "agent_order": [
    "string"
  ]
}

The contract has no example values, so example bodies are generated from each schema: every field is shown with a placeholder of its type.

Used by

PATCH/v1/settings/{section}
Change named fields of one settings section

Generated from contract version 1. Last updated November 12, 2026.