Skip to main content
GET
/
api
/
v1
/
user
/
settings
Get Full Settings
curl --request GET \
  --url https://api.example.com/api/v1/user/settings \
  --header 'Authorization: Bearer <token>'
{
  "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.

Response

200 - application/json

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