> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tembo.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Update user settings

> Configure personal agent/model and project defaults, system instructions, follow-up queue/steer behavior, VM restart, commit signing/attribution, notifications, themes, and review layout. Updates preserve unrelated settings.



## OpenAPI

````yaml https://api.tembo.io/public-api/openapi/public patch /v1/users/{userId}/settings
openapi: 3.1.0
info:
  title: Tembo Public API
  description: >-
    Manage agents, sessions, repositories, and organization resources with the
    Tembo API.
  version: 1.0.0
servers:
  - url: https://api.tembo.io
    description: Tembo API
  - url: https://{deployment-origin}/api/public-api
    description: Self-hosted Tembo
    variables:
      deployment-origin:
        default: tembo.example.com
        description: Hostname of your self-hosted Tembo deployment
security: []
paths:
  /v1/users/{userId}/settings:
    patch:
      tags:
        - Users
      summary: Update user settings
      description: >-
        Configure personal agent/model and project defaults, system
        instructions, follow-up queue/steer behavior, VM restart, commit
        signing/attribution, notifications, themes, and review layout. Updates
        preserve unrelated settings.
      operationId: updateUserSettings
      parameters:
        - in: path
          name: userId
          schema:
            type: string
            minLength: 1
            maxLength: 255
          required: true
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                defaultSessionVisibilityByWorkspace:
                  type: object
                  propertyNames:
                    type: string
                    minLength: 1
                    maxLength: 255
                  additionalProperties:
                    type: string
                    enum:
                      - private
                      - public
                  description: >-
                    Default visibility for your new sessions, keyed by workspace
                    ID.
                autoRestartVm:
                  type: boolean
                  description: Automatically restart a session VM when needed.
                defaultProjectId:
                  type:
                    - string
                    - 'null'
                  minLength: 1
                  maxLength: 255
                  description: >-
                    Default project environment for new sessions, or null to
                    clear the preference.
                gpgKey:
                  type: string
                  maxLength: 32768
                  description: >-
                    GPG signing key configuration. This value is returned by
                    retrieveUserSettings.
                includeTemboCommitAttribution:
                  type: boolean
                  description: Include Tembo attribution in agent-created commits.
                openPullRequestsAsBot:
                  type: boolean
                  description: >-
                    Open GitHub pull requests as the Tembo bot instead of your
                    personal account.
                desktopNotificationsEnabled:
                  type: boolean
                  description: Enable or disable desktop notifications.
                desktopNotificationPreferences:
                  type: object
                  properties:
                    awaitingApproval:
                      type: boolean
                    pullRequestOpened:
                      type: boolean
                    pullRequestReviewRequested:
                      type: boolean
                  additionalProperties: false
                  description: Notification types to show on the desktop.
                hasDesktopApp:
                  type: boolean
                  description: Whether the user has signed in to the Tembo desktop app.
                openLinksInDesktopApp:
                  type: boolean
                  description: >-
                    Open Tembo links from the browser in the desktop app when it
                    is installed.
                appearancePreferences:
                  type: object
                  properties:
                    appTheme:
                      type: string
                      enum:
                        - light
                        - dark
                        - system
                    accentTheme:
                      type: object
                      properties:
                        themeId:
                          type: string
                          maxLength: 255
                        customSurface:
                          type:
                            - string
                            - 'null'
                          maxLength: 4096
                        customAccent:
                          type:
                            - string
                            - 'null'
                          maxLength: 4096
                        customIntensity:
                          type: number
                          minimum: 0.25
                          maximum: 2
                        systemLight:
                          type: string
                          maxLength: 255
                        systemDark:
                          type: string
                          maxLength: 255
                      additionalProperties: false
                  additionalProperties: false
                  description: >-
                    Theme, accent, and appearance preferences. Nested updates
                    preserve unrelated preferences.
                appSidebarPreferences:
                  type: object
                  properties:
                    open:
                      type: boolean
                    sessionOwnerScope:
                      type: string
                      enum:
                        - mine
                        - team
                    sessionSortBy:
                      type: string
                      enum:
                        - createdAt
                        - updatedAt
                    sessionOrganization:
                      type: string
                      enum:
                        - list
                        - project
                    showArchivedSessions:
                      type: boolean
                    showActivity:
                      type: boolean
                    width:
                      type: number
                      minimum: 0
                      maximum: 10000
                    rightSidebar:
                      type: object
                      propertyNames:
                        type: string
                        minLength: 1
                        maxLength: 255
                      additionalProperties:
                        type: object
                        properties:
                          open:
                            type: boolean
                          width:
                            type: string
                            maxLength: 255
                        additionalProperties: false
                  additionalProperties: false
                  description: Application sidebar layout preferences.
                diffPreferences:
                  type: object
                  properties:
                    style:
                      type: string
                      enum:
                        - unified
                        - split
                    indicators:
                      type: string
                      enum:
                        - classic
                        - bars
                        - none
                    overflow:
                      type: string
                      enum:
                        - scroll
                        - wrap
                    showLineNumbers:
                      type: boolean
                    expandUnchanged:
                      type: boolean
                    showFileTree:
                      type: boolean
                    fileTreePosition:
                      type: string
                      enum:
                        - left
                        - right
                    fileTreeView:
                      type: string
                      enum:
                        - list
                        - tree
                    lightTheme:
                      type: string
                      maxLength: 255
                    darkTheme:
                      type: string
                      maxLength: 255
                  additionalProperties: false
                  description: Diff display and comparison preferences.
                dashboardPreferences:
                  type: object
                  properties:
                    taskFilters:
                      type: object
                      properties:
                        statusFilter:
                          type: array
                          items:
                            type: string
                            maxLength: 4096
                          maxItems: 100
                        sortBy:
                          type: string
                          enum:
                            - createdAt
                            - updatedAt
                        searchQuery:
                          type: string
                          maxLength: 4096
                        integrationType:
                          type: array
                          items:
                            type: string
                            maxLength: 4096
                          maxItems: 100
                        externalId:
                          type: string
                          maxLength: 4096
                        projectFilter:
                          type: array
                          items:
                            type: string
                            maxLength: 4096
                          maxItems: 100
                        authorFilter:
                          type: array
                          items:
                            type: string
                            maxLength: 4096
                          maxItems: 100
                        prStatusFilter:
                          type: array
                          items:
                            type: string
                            maxLength: 4096
                          maxItems: 100
                        automationFilter:
                          type: array
                          items:
                            type: string
                            maxLength: 4096
                          maxItems: 100
                      additionalProperties: false
                  additionalProperties: false
                  description: Dashboard task-filter preferences.
                composerPreferences:
                  type: object
                  properties:
                    lastSelectedRepositories:
                      type: array
                      items:
                        type: object
                        properties:
                          id:
                            type: string
                            maxLength: 4096
                          name:
                            type: string
                            maxLength: 4096
                          type:
                            type: string
                            maxLength: 255
                        required:
                          - id
                        additionalProperties: false
                      maxItems: 100
                  additionalProperties: false
                  description: >-
                    Message composer preferences, including selected
                    repositories.
                reviewPreferences:
                  type: object
                  properties:
                    fileSortMode:
                      type: string
                      enum:
                        - tree
                        - path-asc
                        - path-desc
                        - largest
                        - smallest
                    excludedFilePatterns:
                      type: array
                      items:
                        type: string
                        minLength: 1
                        maxLength: 255
                      maxItems: 100
                    sections:
                      type: object
                      propertyNames:
                        type: string
                        minLength: 1
                        maxLength: 255
                      additionalProperties:
                        type: boolean
                    hideBotComments:
                      type: boolean
                    layout:
                      type: object
                      properties:
                        focusChatHeight:
                          type: number
                          exclusiveMinimum: 0
                          maximum: 10000
                        activeTab:
                          type: string
                          maxLength: 255
                        activeViewMode:
                          type: string
                          maxLength: 255
                        focusChatOpen:
                          type: boolean
                        focusMode:
                          type: boolean
                        leftDesktopSidebarOpen:
                          type: boolean
                        leftDesktopSidebarWidth:
                          type: number
                          minimum: 0
                          maximum: 10000
                        rightDesktopSidebarOpen:
                          type: boolean
                        rightDesktopSidebarWidth:
                          type: number
                          minimum: 0
                          maximum: 10000
                      additionalProperties: false
                  additionalProperties: false
                  description: >-
                    Code review file sorting, exclusions, bot comment
                    visibility, and layout preferences.
                diffLightTheme:
                  type: string
                  maxLength: 255
                  description: Diff syntax theme for light mode.
                diffDarkTheme:
                  type: string
                  maxLength: 255
                  description: Diff syntax theme for dark mode.
                defaultAgent:
                  type:
                    - string
                    - 'null'
                  pattern: ^[^:]+:[^:]+(?::[^:]+)?$
                  maxLength: 255
                  description: >-
                    Default coding agent and model key. Null clears the
                    preference.
                defaultFastMode:
                  type: boolean
                  description: >-
                    Enable Fast mode by default for new sessions with supported
                    agents.
                followUpBehavior:
                  type: string
                  enum:
                    - queue
                    - steer
                  description: >-
                    Default follow-up delivery: queue a new turn or steer an
                    active turn.
                customSystemPrompt:
                  type: string
                  maxLength: 4096
                  description: Personal system instructions supplied to agents.
              additionalProperties: false
      responses:
        '200':
          description: Update user settings
          content:
            application/json:
              schema:
                type: object
                properties:
                  autoRestartVm:
                    type: boolean
                  defaultProjectId:
                    type:
                      - string
                      - 'null'
                  defaultSessionVisibilityByWorkspace:
                    type: object
                    additionalProperties:
                      type: string
                      enum:
                        - private
                        - public
                  gpgKey:
                    type: string
                  includeTemboCommitAttribution:
                    type: boolean
                  openPullRequestsAsBot:
                    type: boolean
                  desktopNotificationsEnabled:
                    type: boolean
                  desktopNotificationPreferences:
                    type: object
                    properties:
                      awaitingApproval:
                        type: boolean
                      pullRequestOpened:
                        type: boolean
                      pullRequestReviewRequested:
                        type: boolean
                    additionalProperties: false
                  hasDesktopApp:
                    type: boolean
                  openLinksInDesktopApp:
                    type: boolean
                  appearancePreferences:
                    type: object
                    properties:
                      appTheme:
                        type: string
                        enum:
                          - light
                          - dark
                          - system
                      accentTheme:
                        type: object
                        properties:
                          themeId:
                            type: string
                          customSurface:
                            type:
                              - string
                              - 'null'
                          customAccent:
                            type:
                              - string
                              - 'null'
                          customIntensity:
                            type: number
                          systemLight:
                            type: string
                          systemDark:
                            type: string
                        additionalProperties: false
                    additionalProperties: false
                  appSidebarPreferences:
                    type: object
                    properties:
                      open:
                        type: boolean
                      sessionOwnerScope:
                        type: string
                        enum:
                          - mine
                          - team
                      sessionSortBy:
                        type: string
                        enum:
                          - createdAt
                          - updatedAt
                      sessionOrganization:
                        type: string
                        enum:
                          - list
                          - project
                      showArchivedSessions:
                        type: boolean
                      showActivity:
                        type: boolean
                      width:
                        type: number
                      rightSidebar:
                        type: object
                        additionalProperties:
                          type: object
                          properties:
                            open:
                              type: boolean
                            width:
                              type: string
                          additionalProperties: false
                    additionalProperties: false
                  diffPreferences:
                    type: object
                    properties:
                      style:
                        type: string
                        enum:
                          - unified
                          - split
                      indicators:
                        type: string
                        enum:
                          - classic
                          - bars
                          - none
                      overflow:
                        type: string
                        enum:
                          - scroll
                          - wrap
                      showLineNumbers:
                        type: boolean
                      expandUnchanged:
                        type: boolean
                      showFileTree:
                        type: boolean
                      fileTreePosition:
                        type: string
                        enum:
                          - left
                          - right
                      fileTreeView:
                        type: string
                        enum:
                          - list
                          - tree
                      lightTheme:
                        type: string
                      darkTheme:
                        type: string
                    additionalProperties: false
                  dashboardPreferences:
                    type: object
                    properties:
                      taskFilters:
                        type: object
                        properties:
                          statusFilter:
                            type: array
                            items:
                              type: string
                          sortBy:
                            type: string
                            enum:
                              - createdAt
                              - updatedAt
                          searchQuery:
                            type: string
                          integrationType:
                            type: array
                            items:
                              type: string
                          externalId:
                            type: string
                          projectFilter:
                            type: array
                            items:
                              type: string
                          authorFilter:
                            type: array
                            items:
                              type: string
                          prStatusFilter:
                            type: array
                            items:
                              type: string
                          automationFilter:
                            type: array
                            items:
                              type: string
                        additionalProperties: false
                    additionalProperties: false
                  composerPreferences:
                    type: object
                    properties:
                      lastSelectedRepositories:
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: string
                            name:
                              type: string
                            type:
                              type: string
                          required:
                            - id
                          additionalProperties: false
                    additionalProperties: false
                  reviewPreferences:
                    type: object
                    properties:
                      fileSortMode:
                        type: string
                        enum:
                          - tree
                          - path-asc
                          - path-desc
                          - largest
                          - smallest
                      excludedFilePatterns:
                        type: array
                        items:
                          type: string
                      sections:
                        type: object
                        additionalProperties:
                          type: boolean
                      hideBotComments:
                        type: boolean
                      layout:
                        type: object
                        properties:
                          focusChatHeight:
                            type: number
                          activeTab:
                            type: string
                          activeViewMode:
                            type: string
                          focusChatOpen:
                            type: boolean
                          focusMode:
                            type: boolean
                          leftDesktopSidebarOpen:
                            type: boolean
                          leftDesktopSidebarWidth:
                            type: number
                          rightDesktopSidebarOpen:
                            type: boolean
                          rightDesktopSidebarWidth:
                            type: number
                        additionalProperties: false
                    additionalProperties: false
                  diffLightTheme:
                    type: string
                  diffDarkTheme:
                    type: string
                  defaultAgent:
                    type: string
                    pattern: ^[^:]+:[^:]+(?::[^:]+)?$
                  defaultFastMode:
                    type: boolean
                  followUpBehavior:
                    type: string
                    enum:
                      - queue
                      - steer
                  customSystemPrompt:
                    type: string
                    maxLength: 4096
                additionalProperties: false
        '400':
          description: >-
            Invalid request or missing required organization or user
            information.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
                additionalProperties: false
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
                additionalProperties: false
        '404':
          description: User or connected account not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
                additionalProperties: false
        '500':
          description: User operation failed
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
                additionalProperties: false
      security:
        - apiKey: []
      x-codeSamples:
        - lang: typescript
          label: TypeScript SDK
          source: |
            import Tembo from '@tembo-io/sdk';

            const client = new Tembo();

            const setting = await client.users.settings.update('userId', {});
        - lang: rust
          label: Rust SDK
          source: |
            use tembo_rs::*;

            let client = Tembo::from_env()?;

            let response = client
                .users()
                .settings()
                .update("example", SettingsUpdateBody2::new())
                .send()
                .await?;
components:
  securitySchemes:
    apiKey:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.