> ## Documentation Index
> Fetch the complete documentation index at: https://docs.layest.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Manage Your Layest Profile and Personal Account Settings

> Update your Layest profile name, avatar, email, password, and notification preferences. Manage API keys and connected accounts from your personal settings.

Your Layest profile contains your personal identity information, security credentials, notification preferences, and developer API keys. Unlike workspace settings — which apply to everyone in your team — profile settings are personal and only affect your own account. You can access and update them at any time from any workspace you belong to.

## Accessing Your Profile Settings

Click your **avatar or initials** in the bottom-left corner of the Layest interface, then select **Profile Settings** from the menu. Alternatively, navigate directly to **Account → Profile** from the top-right user menu.

## Updating Display Name and Avatar

Your display name and avatar are visible to other members of your workspace in comments, activity logs, and the members list.

1. In the **Profile** section, click on your current avatar image to open the upload dialog.
2. Select a JPG or PNG file (maximum 5 MB). Square images work best — the avatar is always displayed as a circle.
3. Update your **Display Name** in the text field below the avatar.
4. Click **Save Changes**.

## Changing Your Email Address

1. In the **Account** section, click **Change Email**.
2. Enter your new email address and your current password to verify your identity.
3. Click **Send Verification Email**.
4. Open the verification email sent to your new address and click the confirmation link.
5. Your email address is updated once the link is clicked. Future login attempts and notifications will use the new address.

<Info>
  If you use an OAuth provider (Google, GitHub) to sign in and you change your email, make sure your linked OAuth account also uses the updated address. Otherwise, logging in with OAuth after the change may create a duplicate account.
</Info>

## Changing Your Password

1. In the **Security** section, click **Change Password**.
2. Enter your **Current Password**, then your **New Password**, then confirm the new password in the **Confirm New Password** field.
3. Passwords must be at least 12 characters and include at least one uppercase letter, one number, and one special character.
4. Click **Update Password**. All active sessions except the current one are signed out immediately.

## Notification Preferences

Control which events trigger notifications and how you receive them.

<Tabs>
  <Tab title="Email Notifications">
    Toggle individual email notification types on or off:

    * **Workflow run failures** — get an email when a run you own encounters an error
    * **Agent mentions** — receive an email when someone mentions you in a comment
    * **Workspace invitations** — notified when you are invited to a new workspace
    * **Billing alerts** — spending cap reached or payment failed
    * **Weekly digest** — a summary of your workspace activity every Monday morning
  </Tab>

  <Tab title="In-App Notifications">
    In-app notifications appear as a badge on the bell icon in the top navigation bar. You can enable or disable:

    * Run completions and failures
    * Agent comments and mentions
    * Team member invitations accepted
    * System announcements and product updates
  </Tab>
</Tabs>

After adjusting your preferences, click **Save Notification Settings**.

## Managing Personal API Keys

Personal API keys authenticate requests you make directly to the Layest API — for example, from local development scripts or CI/CD pipelines. They carry your personal permissions and are scoped to the workspaces you are a member of.

### Generating a New API Key

<Steps>
  <Step title="Open the API Keys Section">
    Scroll to the **API Keys** section on your Profile Settings page.
  </Step>

  <Step title="Click Create API Key">
    Click the **Create API Key** button.
  </Step>

  <Step title="Name Your Key">
    Enter a descriptive name for the key so you can identify it later (for example, `local-dev` or `github-actions`).
  </Step>

  <Step title="Set an Expiry (Optional)">
    Choose an expiry period from the dropdown: 30 days, 90 days, 1 year, or **No expiry**. Keys with no expiry remain active until you manually revoke them.
  </Step>

  <Step title="Copy and Store the Key">
    Click **Generate Key**. The full API key is shown **once only**. Copy it immediately and store it securely in a password manager or secrets vault. Layest never displays the full key again after you close this dialog.
  </Step>
</Steps>

### Viewing and Revoking Keys

Active API keys appear in a list showing the key name, creation date, expiry date, and the date it was last used. To revoke a key, click the **Revoke** button on its row and confirm. Revocation is immediate — any request using that key will return a `401 Unauthorized` error.

## Connected Accounts

If you signed up with an email and password, you can link an OAuth provider (Google or GitHub) for faster future sign-ins:

1. Go to **Profile Settings → Connected Accounts**.
2. Click **Connect** next to the provider you want to link.
3. Complete the OAuth authorization flow in the popup window.
4. The provider appears as **Connected** and can now be used to sign in.

To disconnect a provider, click **Disconnect** next to it. You must have either a password or at least one other OAuth provider connected before you can disconnect — Layest will not let you remove all authentication methods from your account.

## Deleting Your Account

<Warning>
  Account deletion is **permanent and irreversible**. All your personal data — including your profile, personal API keys, and notification preferences — is deleted immediately. Workspaces where you are the **sole Admin** are also scheduled for deletion. If other Admins exist, you are removed as a member but the workspace continues. Download any data you need and transfer workspace ownership before proceeding.
</Warning>

To delete your account:

1. Scroll to the **Danger Zone** at the bottom of the Profile Settings page.
2. Click **Delete My Account**.
3. Type your email address in the confirmation field to verify your intent.
4. Click **Permanently Delete Account**.

You will be signed out immediately and your account will be queued for deletion. Deletion is processed within 24 hours. If you change your mind, contact support within that window at [support@layest.ai](mailto:support@layest.ai) and the deletion can be cancelled.