Skip to main content
PATCH
TypeScript SDK

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

userId
string
required
Required string length: 1 - 255

Body

application/json
defaultSessionVisibilityByWorkspace
object

Default visibility for your new sessions, keyed by workspace ID.

autoRestartVm
boolean

Automatically restart a session VM when needed.

defaultProjectId
string | null

Default project environment for new sessions, or null to clear the preference.

Required string length: 1 - 255
gpgKey
string

GPG signing key configuration. This value is returned by retrieveUserSettings.

Maximum string length: 32768
includeTemboCommitAttribution
boolean

Include Tembo attribution in agent-created commits.

openPullRequestsAsBot
boolean

Open GitHub pull requests as the Tembo bot instead of your personal account.

desktopNotificationsEnabled
boolean

Enable or disable desktop notifications.

desktopNotificationPreferences
object

Notification types to show on the desktop.

hasDesktopApp
boolean

Whether the user has signed in to the Tembo desktop app.

Open Tembo links from the browser in the desktop app when it is installed.

appearancePreferences
object

Theme, accent, and appearance preferences. Nested updates preserve unrelated preferences.

appSidebarPreferences
object

Application sidebar layout preferences.

diffPreferences
object

Diff display and comparison preferences.

dashboardPreferences
object

Dashboard task-filter preferences.

composerPreferences
object

Message composer preferences, including selected repositories.

reviewPreferences
object

Code review file sorting, exclusions, bot comment visibility, and layout preferences.

diffLightTheme
string

Diff syntax theme for light mode.

Maximum string length: 255
diffDarkTheme
string

Diff syntax theme for dark mode.

Maximum string length: 255
defaultAgent
string | null

Default coding agent and model key. Null clears the preference.

Maximum string length: 255
Pattern: ^[^:]+:[^:]+(?::[^:]+)?$
defaultFastMode
boolean

Enable Fast mode by default for new sessions with supported agents.

followUpBehavior
enum<string>

Default follow-up delivery: queue a new turn or steer an active turn.

Available options:
queue,
steer
customSystemPrompt
string

Personal system instructions supplied to agents.

Maximum string length: 4096

Response

Update user settings

autoRestartVm
boolean
defaultProjectId
string | null
defaultSessionVisibilityByWorkspace
object
gpgKey
string
includeTemboCommitAttribution
boolean
openPullRequestsAsBot
boolean
desktopNotificationsEnabled
boolean
desktopNotificationPreferences
object
hasDesktopApp
boolean
appearancePreferences
object
appSidebarPreferences
object
diffPreferences
object
dashboardPreferences
object
composerPreferences
object
reviewPreferences
object
diffLightTheme
string
diffDarkTheme
string
defaultAgent
string
Pattern: ^[^:]+:[^:]+(?::[^:]+)?$
defaultFastMode
boolean
followUpBehavior
enum<string>
Available options:
queue,
steer
customSystemPrompt
string
Maximum string length: 4096