Settings 🟡 PREVIEW - User Preferences

Your profile, security, and preferences

Settings Interface Screen

Overview

Settings is the user preferences application in General Bots Suite. Manage your profile, security credentials, appearance, notifications, and third-party integrations. Settings gives you full control over how the platform looks, feels, and behaves across all your sessions.

Features

Profile

SettingDescription
AvatarUpload or change your profile picture
Display NameYour visible name across the suite
Email AddressPrimary email for notifications
BioShort description of your role
LanguagePreferred language for the interface

Security

SettingDescription
Change PasswordUpdate your account password
Two-Factor AuthenticationEnable 2FA via authenticator app
Active SessionsView and revoke active sessions
Login HistoryRecent login attempts and locations
API KeysGenerate and manage access tokens

Appearance

SettingDescription
ThemeLight, dark, or system default
Accent ColorPrimary color for the interface
Font SizeSmall, medium, or large
Compact ModeReduce spacing for dense views
Sidebar PositionLeft or right placement

Notifications

ChannelOptions
EmailFrequency, digest, critical-only
PushBrowser push notifications
In-AppReal-time badges and banners
SoundNotification sounds on/off
Quiet HoursDo-not-disturb schedule

Integrations

IntegrationDescription
API KeysCreate and revoke programmatic access
WebhooksConfigure event-driven callbacks
OAuth AppsManage connected applications
SSO SettingsSingle sign-on configuration

Keyboard Shortcuts

ShortcutAction
G then PGo to Profile
G then SGo to Security
G then AGo to Appearance
G then NGo to Notifications
G then IGo to Integrations
Ctrl+SSave changes
EscapeCancel editing

Settings via Chat

Changing Your Theme

Enabling Two-Factor Authentication

Updating Your Profile

API Endpoints

EndpointMethodDescription
/api/users/meGETGet current user profile
/api/users/mePATCHUpdate profile fields
/api/users/me/securityGETSecurity settings and session list
/api/users/me/security/passwordPUTChange password
/api/users/me/security/2faPOSTEnable 2FA
/api/users/me/security/2faDELETEDisable 2FA
/api/users/me/sessionsGETList active sessions
/api/users/me/sessions/:idDELETERevoke a session
/api/users/me/notificationsGETNotification preferences
/api/users/me/notificationsPUTUpdate notification preferences
/api/users/me/api-keysGETList API keys
/api/users/me/api-keysPOSTGenerate new API key
/api/users/me/api-keys/:idDELETERevoke API key

Profile Update Request

{
    "display_name": "Marketing Lead",
    "avatar_url": "https://cdn.example.com/avatars/user123.png",
    "language": "en",
    "bio": "Leading marketing initiatives"
}

Profile Response

{
    "id": "usr-abc123",
    "display_name": "Marketing Lead",
    "email": "user@company.com",
    "avatar_url": "https://cdn.example.com/avatars/user123.png",
    "language": "en",
    "theme": "dark",
    "created_at": "2024-01-15T08:00:00Z"
}

Configuration

Settings are stored per-user in the database. Default values can be overridden in config.csv:

key,value
default-theme,dark
default-language,en
allow-2fa,true
max-sessions,5

Troubleshooting

Theme Not Applying

  1. Clear browser cache
  2. Check if system theme override is active
  3. Refresh the page
  4. Verify no conflicting browser extensions

2FA Locked Out

  1. Use your backup codes from initial setup
  2. Contact an administrator to reset 2FA
  3. Verify authenticator app time is synced

Notifications Not Arriving

  1. Check notification preferences are enabled
  2. Verify browser push notification permissions
  3. Check email spam folder for digest emails
  4. Ensure quiet hours are not blocking delivery

See Also