Skip to main content
PATCH
/
api
/
v1
/
user
/
settings
Update User Settings
curl --request PATCH \
  --url https://api.example.com/api/v1/user/settings \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "notifications": {
    "mobile": {
      "mode": "mobile_only"
    },
    "email": {
      "enabled": false,
      "notification_email": "<string>"
    },
    "sms": {
      "enabled": false,
      "phone_number": "<string>"
    }
  },
  "git": {
    "default_worktree_mode": "new_worktree"
  },
  "code": {
    "mode": "agent",
    "default_provider": "<string>",
    "providers": {
      "claude_code": {
        "model": "haiku"
      },
      "codex": {
        "model": "gpt-5.1-codex-max",
        "thinking": "low"
      }
    }
  },
  "voice": {
    "language": "<string>"
  }
}
'
{
  "notifications": {
    "mobile": {
      "mode": "mobile_only"
    },
    "email": {
      "enabled": false,
      "notification_email": "<string>"
    },
    "sms": {
      "enabled": false,
      "phone_number": "<string>"
    }
  },
  "git": {
    "default_worktree_mode": "new_worktree"
  },
  "code": {
    "mode": "agent",
    "default_provider": "<string>",
    "providers": {
      "claude_code": {
        "model": "haiku"
      },
      "codex": {
        "model": "gpt-5.1-codex-max",
        "thinking": "low"
      }
    }
  },
  "voice": {
    "language": "<string>"
  }
}

Authorizations

Authorization
string
header
required

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

Body

application/json

Patch request for updating user settings.

notifications
NotificationSettings · object

Notification preferences for the user

git
GitUserSettings · object

User-level git defaults for new sessions

code
CodeAgentSettings · object

Code agent settings across providers

voice
VoiceAgentSettings · object

Voice agent settings

Response

Successful Response

Complete user settings stored as JSONB.

notifications
NotificationSettings · object

Notification preferences for the user

git
GitUserSettings · object

User-level git defaults for new sessions

code
CodeAgentSettings · object

Code agent settings across providers

voice
VoiceAgentSettings · object

Voice agent settings