---
title: "PUT /api/settings"
method: PUT
path: "/api/settings"
tags: ["Ai.Tlbx.MidTerm.OpenApi"]
---

# PUT /api/settings

`PUT /api/settings`

## Request body

- MidTermSettingsPublic
  - `defaultShell` unknown, required
  - `defaultCols` integer, required
  - `defaultRows` integer, required
  - `defaultWorkingDirectory` string, required
  - `terminalEnvironmentVariables` string, required
  - `codexYoloDefault` boolean, required
  - `codexDefaultAppServerControlModel` string, required
  - `codexEnvironmentVariables` string, required
  - `claudeDangerouslySkipPermissionsDefault` boolean, required
  - `claudeDefaultAppServerControlModel` string, required
  - `claudeEnvironmentVariables` string, required
  - `agentMessageFontFamily` string, required
  - `showAgentMessageTimestamps` boolean, required
  - `showUnknownAgentMessages` boolean, required
  - `toolCallOutputLines` integer, required
  - `fontSize` integer, required
  - `fontFamily` string, required
  - `terminalLigaturesEnabled` boolean, required
  - `lineHeight` number, double, required
  - `letterSpacing` number, double, required
  - `fontWeight` string, required
  - `fontWeightBold` string, required
  - `customGlyphs` boolean, required
  - `boxDrawingStyle` string, required
  - `boxDrawingScale` number, double, required
  - `cursorStyle` 'bar' | 'block' | 'underline', required
  - `cursorBlink` boolean, required
  - `cursorInactiveStyle` 'outline' | 'block' | 'bar' | 'underline' | 'none', required
  - `theme` 'dark' | 'light' | 'solarizedDark' | 'solarizedLight', required
  - `terminalColorScheme` string, required
  - `terminalColorSchemes` TerminalColorSchemeDefinition[], required
    - `name` string, required
    - `background` string, required
    - `foreground` string, required
    - `cursor` string, required
    - `cursorAccent` string, required
    - `selectionBackground` string, required
    - `scrollbarSliderBackground` string, required
    - `scrollbarSliderHoverBackground` string, required
    - `scrollbarSliderActiveBackground` string, required
    - `black` string, required
    - `red` string, required
    - `green` string, required
    - `yellow` string, required
    - `blue` string, required
    - `magenta` string, required
    - `cyan` string, required
    - `white` string, required
    - `brightBlack` string, required
    - `brightRed` string, required
    - `brightGreen` string, required
    - `brightYellow` string, required
    - `brightBlue` string, required
    - `brightMagenta` string, required
    - `brightCyan` string, required
    - `brightWhite` string, required
  - `backgroundImageEnabled` boolean, required
  - `hideBackgroundImageOnMobile` boolean, required
  - `backgroundImageFileName` string, nullable, required
  - `backgroundImageRevision` integer, required
  - `backgroundKenBurnsEnabled` boolean, required
  - `backgroundKenBurnsZoomPercent` integer, required
  - `backgroundKenBurnsSpeedPxPerSecond` integer, required
  - `uiTransparency` integer, required
  - `terminalTransparency` integer, nullable, required
  - `terminalCellBackgroundTransparency` integer, nullable, required
  - `tabTitleMode` 'hostname' | 'static' | 'sessionName' | 'terminalTitle' | 'foregroundProcess', required
  - `minimumContrastRatio` number, double, required
  - `smoothScrolling` boolean, required
  - `scrollbarStyle` 'off' | 'hover' | 'always', required
  - `useWebGL` boolean, required
  - `terminalThemeLightnessBoost` integer, required
  - `scrollbackLines` integer, required
  - `scrollbackBytes` integer, required
  - `bellStyle` 'notification' | 'sound' | 'visual' | 'both' | 'off', required
  - `copyOnSelect` boolean, required
  - `rightClickPaste` boolean, required
  - `clipboardShortcuts` 'auto' | 'windows' | 'unix', required
  - `terminalEnterMode` 'default' | 'shiftEnterLineFeed', required
  - `scrollbackProtection` boolean, required
  - `mobileKineticTerminalScroll` boolean, required
  - `mobileDenseTerminalMode` boolean, required
  - `keepSystemAwakeWithActiveSessions` boolean, required
  - `resumeMode` 'fullReplay' | 'quickResume', required
  - `tryResumeNonAiAgentProcesses` boolean, required
  - `preserveTerminalCursorControl` boolean, required
  - `inputMode` string, required
  - `fileRadar` boolean, required
  - `showBookmarks` boolean, required
  - `allowAdHocSessionBookmarks` boolean, required
  - `showSidebarSessionFilter` boolean, required
  - `worktreeRootDirectory` string, required
  - `tmuxCompatibility` boolean, required
  - `managerBarEnabled` boolean, required
  - `actionGraphsEnabled` boolean, required
  - `actionGraphsDefaultCwd` string, required
  - `commandBayLigaturesEnabled` boolean, required
  - `devMode` boolean, required
  - `terminalLatencyDiagnosticsEnabled` boolean, required
  - `terminalInputCoalescingMs` integer, required
  - `showChangelogAfterUpdate` boolean, required
  - `showUpdateNotification` boolean, required
  - `updateChannel` string, nullable, required
  - `language` 'auto' | 'en' | 'zh' | 'es' | 'hi' | 'fr' | 'bn' | 'pt' | 'ru' | 'ja' | 'de', required
  - `managerBarButtons` ManagerBarButton[], required
    - `id` string, required
    - `label` string, required
    - `text` string, required
    - `actionType` string, required
    - `prompts` string[], required
    - `trigger` ManagerBarTrigger, required
      - `kind` string, required
      - `repeatCount` integer, required
      - `repeatEveryValue` integer, required
      - `repeatEveryUnit` string, required
      - `schedule` ManagerBarScheduleEntry[], required
        - `timeOfDay` string, required
        - `repeat` string, required
  - `runAsUser` string, nullable, required
  - `runAsUserSid` string, nullable, required
  - `authenticationEnabled` boolean, required
  - `certificatePath` string, nullable, required
  - `hubMachines` HubMachineInfo[], required
    - `id` string, required
    - `name` string, required
    - `baseUrl` string, required
    - `enabled` boolean, required
    - `hasApiKey` boolean, required
    - `hasPassword` boolean, required
    - `lastFingerprint` string, nullable, required
    - `pinnedFingerprint` string, nullable, required

## Response `200`

OK

---

[API](https://skmtc.net/tlbx-ai/apis/tlbx-api.md) · [All operations](https://skmtc.net/tlbx-ai/apis/tlbx-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tlbx-ai/tlbx-api/versions/fbbda676c858/schema)