Skip to content
Help Center Guide · Account & Workspace Settings
3 min readVerified 2026-11-16

Profile & Preferences

Update your personal login details, interface language, timezone formatting, and notification preferences.

In This Guide

Overview

Your personal operator profile governs how you authenticate into the Passinstance Dashboard (/settings/account/profile, /preferences, /notifications, /authentication, /two-factor-authentication, and /sessions), how interface strings and timestamps are localized in your browser session, and how security advisories reach you. Unlike workspace-wide settings under Company Settings, changes made in Account -> Profile & Preferences apply strictly to your individual User identity without altering end-user pass locales or your colleagues' dashboard views.

User Identity, MFA & Session Lifecycle Architecture

SYSTEM ARCHITECTURE FLOW
INTERACTIVE ARCHITECTURE
OPERATOR PROFILE, TOTP 2FA & SESSION MANAGEMENT
STAGE 01 OPERATOR BROWSER / CLIENT LAYER
Profile & Locale UI
(/settings/account/*)
Authenticator App
(RFC 6238 TOTP 6-Digit)
Active Device
Sessions Manager
STAGE 02 USERS, AUTH & SESSION CONTROLLERS (API)
Identity & Preferences
GET/api/v1/users/me/profile
PUT/api/v1/users/me/profile
`PUT/api/v1/users/:id/preferences
Theme: light | dark | system
Security & Session Enforcement
POST/api/v1/auth/2fa/setup
POST/api/v1/auth/2fa/verify
POST/api/v1/users/change-passw
DELETE/api/v1/sessions/:id
STAGE 03 PERSISTENCE & SECURITY AUDIT LAYER
User Record (Encrypted TOTP Secret, Bcrypt Password Hash, Backup Codes)
in-memory cache Refresh Token Store (Immediate Session Invalidation on Password Change)

Important: Changing your personal Interface Language or Theme Preference affects only your dashboard session. Customer-facing pass strings, smart download pages (/d/:slug), and PassFlow enrollment forms always follow the locale rules configured on the respective Pass Template and Company Settings.

Personal Profile & Interface Preferences

Navigate to Account -> Profile (/settings/account/profile) and Preferences (/settings/account/preferences) to configure your operator identity and UI preferences:

SettingAPI FieldBehavior & Scope
Display Name & AvatarfirstName, lastName / PUT /api/v1/users/me/avatarDisplayed in team member rosters, template revision history, and compliance audit logs (GET /api/v1/audit-log/export.csv).
Interface Languagelocale (en, de, es, fr, it, nl, pt)Controls the dashboard UI translation dictionary independently of workspace or pass template locales.
Theme Modetheme (light, dark, system)Persists your preferred color scheme across devices and synchronizes with semantic CSS design tokens.
Display Timezonetimezone (IANA identifier)Formats activity timestamps in your personal view while preserving workspace timezone alignment for analytics rollups.
Notification Channelsnotifications objectToggles email alerts for batch import completions, certificate expiry warnings, billing receipts, and security login advisories.

Updating Profile & Preferences via API

HTTP
PUT /api/v1/users/me/profile HTTP/1.1
Host: api.passinstance.com
Authorization: Bearer <access_token>
Content-Type: application/json

{
  "firstName": "Elena",
  "lastName": "Rostova",
  "timezone": "Europe/Berlin"
}

Use PUT /api/v1/users/:userId/preferences (or GET /api/v1/users/me/settings) to update interface locale, theme, and notification flags:

JSON
{
  "id": "usr_019331a0-4c22-7b10-8a99-112233445566",
  "email": "elena.rostova@example.com",
  "firstName": "Elena",
  "lastName": "Rostova",
  "locale": "en",
  "timezone": "Europe/Berlin",
  "theme": "dark",
  "twoFactorEnabled": true,
  "updatedAt": "2026-11-16T09:31:00.000Z"
}

Two-Factor Authentication (TOTP 2FA) Enrollment

Passinstance supports RFC 6238 Time-Based One-Time Password (TOTP) multi-factor authentication at /settings/account/two-factor-authentication compatible with 1Password, Google Authenticator, Authy, and Apple Passwords. Workspaces can also mandate 2FA enforcement for administrative roles via Team Members & Permissions.

  1. 1
    Generate Secret & QR URI (POST /api/v1/auth/2fa/setup): Returns an encrypted otpauth://totp/ provisioning URI and base32 secret key (GET /api/v1/auth/2fa/status inspects current status).
  2. 2
    Verify & Activate (POST /api/v1/auth/2fa/verify + /api/v1/auth/2fa/enable): Submit a valid 6-digit code from your authenticator app to activate 2FA and receive single-use emergency recovery codes (POST /api/v1/auth/2fa/regenerate-backup-codes rotates them).
  3. 3
    Recovery Code Storage: Store generated recovery codes securely; each code can be consumed only once if your mobile authenticator device is lost.
HTTP
POST /api/v1/auth/2fa/verify HTTP/1.1
Host: api.passinstance.com
Authorization: Bearer <access_token>
Content-Type: application/json

{
  "code": "482910"
}
JSON
{
  "twoFactorEnabled": true,
  "verifiedAt": "2026-11-16T09:32:15.000Z",
  "recoveryCodes": [
    "PI-894A-221C",
    "PI-773B-904D",
    "PI-112E-665F",
    "PI-550C-338A"
  ]
}

Password Rotation & Active Session Management

Under Account -> Authentication (/settings/account/authentication) and Sessions (/settings/account/sessions), you can rotate your password and inspect all currently authenticated sessions linked to your user account:

  • Password Rotation (POST /api/v1/users/change-password): Requires verification of your current password (and active TOTP code if 2FA is enabled). Rotating your password automatically revokes all other active refresh tokens across secondary devices.
  • Session Inspection & Revocation (GET /api/v1/users/sessions, DELETE /api/v1/sessions/:sessionId, and DELETE /api/v1/sessions/others): Displays active session IP, browser/OS User-Agent, device trust state (/api/v1/sessions/trust-device), and last-active timestamp for remote sign-out.

Ready to launch your first pass program?

Create your workspace, configure your pass template, and test a real pass in Apple Wallet and Google Wallet before you scale.