Account Settings¶

Your account settings let you update your name, change your login email address, and manage your password. All settings are under Account in the top-right profile menu.

Update your display name¶

1. Go to Account (top-right menu) → Account Settings (/account).
2. In the Personal Information section, edit the Full Name field.
3. Click Save Changes.

Change your email address (login)¶

Your email address is your login credential. Changing it requires a two-step verification flow to prevent unauthorized changes.

How it works¶

1. Go to Account → Account Settings (/account).
2. In the Email Address row, click Change email.
3. Enter your new email address and your current password in the inline form, then click Send verification email.
4. A verification link is sent to the new address. Your login email does not change until you click that link.
5. Open the email and click the verification link. You are taken to /verify-login-change which confirms the change and signs you in.

Error cases¶

Password requirements¶

Passwords must be at least 12 characters long. There is no maximum length.

If you have forgotten your password, use the Forgot password link on the login page to receive a reset email.

Security settings¶

Two-factor authentication (MFA), recovery codes, and account lockout are managed separately under Account → Security. See the Multi-Factor Authentication guide for the full walkthrough.

Escalation phone number¶

If your organization uses alerting escalation chains with a call step, you'll be reachable by an automated voice call once you've added and verified a phone number under Account → Security. This is also what enables the phone notification channel.

1. Enter your number in E.164 format (e.g. +4915112345678).
2. You'll receive an automated call reading back a 6-digit code — enter it to confirm. The code expires after 15 minutes and allows 5 attempts.
3. Once verified, phone becomes available in your notification preferences and you can be targeted by an escalation call step.

See the Telephony API for the full request/response reference, error codes, and how the escalation call itself works (including acknowledging by pressing 1).

Organization membership¶

View your organizations¶

Your account can belong to more than one organization. To see all organizations you are a member of:

• Dashboard: The organization switcher in the top navigation lists every org your account belongs to.
• CLI: bnerd org list
• API: GET /accounts/me — inspect memberships[] for the full list.

Switch active organization¶

• Dashboard: Click the organization name in the top navigation and select a different organization from the switcher. The dashboard injects ?organization_id=<uuid> on all subsequent requests automatically. Your selection is persisted server-side as your default_organization_id — the next session opens directly in the same organization without any extra parameter.
• CLI: bnerd org switch (interactive menu) or bnerd org switch <org-id> (direct). Writes the active org to ~/.bnerd.yaml.

Persist a default organization (API)¶

If you hold more than one membership, you can explicitly set which organization the API should use when no ?organization_id parameter is provided:

PATCH /accounts/me
Content-Type: application/json

{
  "account": {
    "default_organization_id": "<org-uuid>"
  }
}

The org UUID must be one you hold a membership in — any unknown or non-member UUID returns 403 (fail-closed; existence is not leaked).

You can clear the default by setting default_organization_id: null, but only if you belong to exactly one organization. Clearing while holding multiple memberships is rejected with 422 — doing so would leave the resolver with no fallback, denying every subsequent request that omits the parameter. Set a valid default instead of clearing it in the multi-org case.

Join an additional organization¶

An organization admin sends you an invitation email. Open the link in the email to review and accept the invitation — no login is required for the accept step. Once accepted, the new organization appears immediately in your switcher and in memberships[] on GET /accounts/me.