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
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:
| Setting | API Field | Behavior & Scope |
|---|---|---|
| Display Name & Avatar | firstName, lastName / PUT /api/v1/users/me/avatar | Displayed in team member rosters, template revision history, and compliance audit logs (GET /api/v1/audit-log/export.csv). |
| Interface Language | locale (en, de, es, fr, it, nl, pt) | Controls the dashboard UI translation dictionary independently of workspace or pass template locales. |
| Theme Mode | theme (light, dark, system) | Persists your preferred color scheme across devices and synchronizes with semantic CSS design tokens. |
| Display Timezone | timezone (IANA identifier) | Formats activity timestamps in your personal view while preserving workspace timezone alignment for analytics rollups. |
| Notification Channels | notifications object | Toggles email alerts for batch import completions, certificate expiry warnings, billing receipts, and security login advisories. |
Updating Profile & Preferences via API
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:
{
"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
Generate Secret & QR URI (
POST /api/v1/auth/2fa/setup): Returns an encryptedotpauth://totp/provisioning URI and base32 secret key (GET /api/v1/auth/2fa/statusinspects current status). -
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-codesrotates them). -
3
Recovery Code Storage: Store generated recovery codes securely; each code can be consumed only once if your mobile authenticator device is lost.
POST /api/v1/auth/2fa/verify HTTP/1.1
Host: api.passinstance.com
Authorization: Bearer <access_token>
Content-Type: application/json
{
"code": "482910"
}
{
"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, andDELETE /api/v1/sessions/others): Displays active session IP, browser/OSUser-Agent, device trust state (/api/v1/sessions/trust-device), and last-active timestamp for remote sign-out.
Related Documentation
-
Configure workspace-level security policies in Account Security & Access.
-
Set organization currency, legal address, and default locale in Company Settings.
