> For the complete documentation index, see [llms.txt](https://docs.maiagent.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.maiagent.ai/maiagent-user-guide/en/start/profile.md).

# Personal Account Settings

A guide to each tab on the Account page: profile and avatar, personal preferences, My Organizations, invitation management, changing your password, deleting your account, and the Credit quota, API key

Every user has their own <mark style="color:blue;">Account</mark> page, where you can update your name and avatar, change your password, see which organizations you belong to, and manage your Credit quota, API keys, and AI memory in the current organization. This page requires no role permissions; all logged-in members can see it.

## How to Access <a href="#how-to-access" id="how-to-access"></a>

Click your avatar or name in the top-right of the back office and select <mark style="color:blue;">Account</mark>. The tabs on the left side of the page are divided into two groups:

| Group                                                                               | Tab                                                    | What it manages                                                                                      |
| ----------------------------------------------------------------------------------- | ------------------------------------------------------ | ---------------------------------------------------------------------------------------------------- |
| <mark style="color:blue;">Personal Account</mark> (shared across all organizations) | <mark style="color:blue;">Profile</mark>               | Avatar, name, company name; personal preferences and custom attributes; delete account               |
|                                                                                     | <mark style="color:blue;">My Organizations</mark>      | The organizations you belong to, and pinning                                                         |
|                                                                                     | <mark style="color:blue;">Invitation Management</mark> | Your personal invitation code, invitation link, and invitation emails                                |
|                                                                                     | <mark style="color:blue;">Account Security</mark>      | Change password                                                                                      |
| Current organization name (applies only to the current organization)                | <mark style="color:blue;">Credit Quota</mark>          | Your personal quota in this organization; appears only when the organization uses Credits billing    |
|                                                                                     | <mark style="color:blue;">API Keys</mark>              | Personal API keys you issued yourself                                                                |
|                                                                                     | <mark style="color:blue;">AI Memory</mark>             | Preferences and facts remembered by Agents; appears only when the organization has AI memory enabled |

The heading of the second group is the name of the current organization. To view the quota or keys of another organization, switch organizations first; see [Switching When You Belong to Multiple Organizations](https://docs.maiagent.ai/maiagent-user-guide/en/start/invitation.md#switch-organization).

## Profile <a href="#profile" id="profile"></a>

### Avatar <a href="#avatar" id="avatar"></a>

Click the avatar to open <mark style="color:blue;">Upload Avatar</mark>, then click <mark style="color:blue;">Choose Image</mark> or drag an image in (JPG/PNG supported, up to 5 MB per file). You can rotate, flip, and zoom to adjust the crop area. When you are done, click <mark style="color:blue;">Confirm and Upload</mark>, and the avatar in the top-right updates immediately.

### Name and Company Name <a href="#name-and-company" id="name-and-company"></a>

Click <mark style="color:blue;">Edit</mark> to change your <mark style="color:blue;">Full Name</mark> and <mark style="color:blue;">Company Name</mark>, then click <mark style="color:blue;">Save</mark>. The <mark style="color:blue;">Company Email</mark> is your login account and cannot be changed here. Your name belongs to the account itself, so every organization you are in sees the same name.

### Personal Preferences and Custom Attributes <a href="#preference-and-attributes" id="preference-and-attributes"></a>

* <mark style="color:blue;">Personal Preferences</mark>: Describe your habits and common scenarios in a piece of text (up to 1,000 characters), and the AI refers to it when interacting with you. For example: "I prefer bulleted replies and Traditional Chinese."
* <mark style="color:blue;">Custom Attributes</mark>: Additional information such as department, job title, and extension. You can add them manually, or click <mark style="color:blue;">Download Template</mark> to get an Excel template, fill it in, and use <mark style="color:blue;">Import Excel</mark> to fill them in bulk. For details, see [Profile: Custom Attributes](https://docs.maiagent.ai/maiagent-user-guide/en/org/overview/custom-attributes.md).

These two items are stored on your member record in the **current organization**, so you need to fill them in separately when you switch to another organization. After making changes, click <mark style="color:blue;">Save</mark> in that section.

### Delete Account <a href="#delete-account" id="delete-account"></a>

At the bottom of <mark style="color:blue;">Profile</mark> is <mark style="color:blue;">Delete Account</mark>, which permanently deletes your account and personal data and cannot be undone.

1. Click <mark style="color:blue;">Delete Account</mark>. The system first checks whether the account can be deleted.
2. If you are the **only member and the only owner** of an organization, the dialog lists "The following organizations solely owned by you will also be deleted:".
3. Enter your email as prompted to confirm, then click <mark style="color:blue;">Confirm Delete</mark>. When finished, <mark style="color:blue;">Account deleted</mark> is displayed and you are logged out.

When <mark style="color:blue;">Unable to delete the account at this time:</mark> appears, the dialog states the reason. Common reasons include:

* You are the **only owner** of an organization that still has other members: first make sure the organization has another owner.
* You created data that must be kept in an organization that is still in use: follow the message to handle it first, or contact the organization administrator for help.

## My Organizations <a href="#my-organizations" id="my-organizations"></a>

Lists all the organizations you have joined; the organization you are currently in is marked <mark style="color:blue;">Currently in use</mark>. Click <mark style="color:blue;">Pin</mark> to move frequently used organizations to the top of the organization switcher menu in the top-left, and click <mark style="color:blue;">Unpin</mark> to restore. Pinning is stored only in the browser on this device.

## Invitation Management <a href="#invitation-management" id="invitation-management"></a>

<mark style="color:blue;">Your Invitation Information</mark> at the top shows your personal <mark style="color:blue;">Invitation Code</mark> (click <mark style="color:blue;">Edit</mark> to change it to something memorable using uppercase letters and numbers) and the corresponding <mark style="color:blue;">Invitation Link</mark>. The three toggles below:

| Toggle                                             | Content                                                                                                                                                                            |
| -------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <mark style="color:blue;">Invitation Code</mark>   | People who registered with your invitation code                                                                                                                                    |
| <mark style="color:blue;">Invitation Link</mark>   | The organization invitation link for the current organization, where you can see the description, expiration time, usage count, and status, and copy the link                      |
| <mark style="color:blue;">Invitation Emails</mark> | Platform invitations sent with <mark style="color:blue;">Invite via Email</mark>, which you can <mark style="color:blue;">Resend</mark> or <mark style="color:blue;">Revoke</mark> |

{% hint style="warning" %}
Personal invitation codes and <mark style="color:blue;">Invitation Emails</mark> are for referring others to register on the platform; after registering, the person will **not** join your organization. To add colleagues to an organization, have an organization administrator invite them from [Member Management](https://docs.maiagent.ai/maiagent-user-guide/en/org/overview/member.md).
{% endhint %}

## Account Security: Change Password <a href="#change-password" id="change-password"></a>

In <mark style="color:blue;">Account Security</mark>, enter your <mark style="color:blue;">Current Password</mark>, <mark style="color:blue;">New Password</mark>, and <mark style="color:blue;">Confirm New Password</mark>, then click <mark style="color:blue;">Change Password</mark>. You are done when you see "Password changed successfully." The new password must be at least 9 characters and include uppercase and lowercase letters, numbers, and special characters.

If you forgot your current password, log out and use [Forgot Password](https://docs.maiagent.ai/maiagent-user-guide/en/start/forget-password.md) instead. Accounts created through your company's single sign-on (SSO) have no platform password; change it in your identity system according to company policy.

## Credit Quota <a href="#credit-quota" id="credit-quota"></a>

This appears only when the organization uses Credits billing. The page header reads "Your personal quota in *organization name*." and <mark style="color:blue;">My Credit Quota</mark> below shows one of the following depending on your situation:

| What is shown                                                               | What it means                                                                               |
| --------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- |
| Quota card (see the fields in the table below)                              | An administrator has allocated a personal quota to you                                      |
| <mark style="color:blue;">You currently have no personal quota limit</mark> | Spending uses the organization wallet directly                                              |
| <mark style="color:blue;">You need a quota to use AI services</mark>        | No quota has been allocated yet or it has expired; contact an administrator to allocate one |
| <mark style="color:blue;">Quota expired</mark> (Your quota expired on …)    | The quota has expired; contact an administrator to allocate a new quota                     |

Fields on the quota card:

| Field                                                                                             | Description                                                                                                                                    |
| ------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| <mark style="color:blue;">Used</mark> progress bar                                                | The proportion of the quota limit that has been consumed                                                                                       |
| <mark style="color:blue;">Quota Limit</mark>, <mark style="color:blue;">Remaining</mark>          | The total quota for this period and the Credits you can still use                                                                              |
| <mark style="color:blue;">Effective Time</mark>, <mark style="color:blue;">Expiration Time</mark> | An expiration time of "Permanent" means it never expires; if there is a deadline, "N days remaining" is also shown                             |
| <mark style="color:blue;">Next Reset</mark>                                                       | The next time a recurring quota (for example, monthly) resets "Used" to zero, with the cycle in parentheses; a one-time quota shows "No reset" |
| <mark style="color:blue;">Allocated By</mark>, <mark style="color:blue;">Notes</mark>             | The administrator who allocated this quota and their comments                                                                                  |

<mark style="color:blue;">My Role Quota</mark> below shows the quota of the roles you belong to, with the same fields, plus a status label in the top-right: <mark style="color:blue;">Active</mark>, <mark style="color:blue;">Low Balance</mark> (85% used), <mark style="color:blue;">Exhausted</mark>, <mark style="color:blue;">Not Allocated</mark>. If you see "This role requires a quota but currently has no valid quota," spending for the entire role (including you) is paused; ask an administrator to allocate a new quota or remove the restriction. "You currently have no role quota limit" means none of your roles has quota control enabled.

People with organization Credit management permission also see an <mark style="color:blue;">Organization Total Usage</mark> link in the page header. For how quotas are allocated and reset, see [Member Credits Quota Management](https://docs.maiagent.ai/maiagent-user-guide/en/others/credits/member-credit-quota.md#member-self-check).

## API Keys <a href="#api-keys" id="api-keys"></a>

A personal access key calls the MaiAgent API as you, with exactly the same permissions as you, and can only be used in the **organization where it was created**. Any member can issue one on their own.

1. Click <mark style="color:blue;">Create Key</mark> (or <mark style="color:blue;">Create Your First Key</mark> if you have no keys yet).
2. Enter a <mark style="color:blue;">Name</mark>, and optionally choose an <mark style="color:blue;">Expiration Time</mark> (leave blank for never expires).
3. Copy the full key immediately. After you close the dialog you can no longer see the full key; if you lose it, revoke it and create a new one.

The list shows only the keys you issued yourself; click <mark style="color:blue;">Revoke</mark> when you no longer use one. Keys issued to you by an administrator are managed by organization administrators, and people with API Key management permission see an <mark style="color:blue;">Organization Key Management</mark> link in the page header. To connect AI tools using a key, see [MaiAgent MCP](https://docs.maiagent.ai/tech/mcp/maiagent-mcp).

## AI Memory <a href="#ai-memory" id="ai-memory"></a>

This appears only when the organization has AI memory enabled. It lists the preferences and facts Agents have remembered from conversations, and you can add, edit, and delete them. For details, see [AI Memory](https://docs.maiagent.ai/maiagent-user-guide/en/work/maigpt/ai-memory.md).

## FAQ <a href="#faq" id="faq"></a>

### I can't see the "Credit Quota" or "AI Memory" tab? <a href="#faq-missing-tabs" id="faq-missing-tabs"></a>

These two tabs appear according to the current organization's settings: if the organization does not use Credits billing, there is no <mark style="color:blue;">Credit Quota</mark>; if the organization has not enabled AI memory, there is no <mark style="color:blue;">AI Memory</mark>. First confirm that the organization in the top-left is the one you want to check.

### I filled in personal preferences, but they disappeared after I switched to another organization? <a href="#faq-preference-per-org" id="faq-preference-per-org"></a>

Personal preferences and custom attributes are stored on your member record in each organization separately. Fill them in again under <mark style="color:blue;">Profile</mark> in that organization.

### My API key doesn't work in another organization? <a href="#faq-api-key-other-org" id="faq-api-key-other-org"></a>

A personal API key is bound to the organization where it was created. Switch to the organization you want to use first, then create a new key under <mark style="color:blue;">API Keys</mark>.

## Further Reading <a href="#further-reading" id="further-reading"></a>

* [Receiving an Invitation: Joining an Organization](https://docs.maiagent.ai/maiagent-user-guide/en/start/invitation.md)
* [Notification Center](https://docs.maiagent.ai/maiagent-user-guide/en/start/notifications.md)
* [Profile: Custom Attributes](https://docs.maiagent.ai/maiagent-user-guide/en/org/overview/custom-attributes.md)
* [Member Credits Quota Management](https://docs.maiagent.ai/maiagent-user-guide/en/others/credits/member-credit-quota.md)
* [AI Memory](https://docs.maiagent.ai/maiagent-user-guide/en/work/maigpt/ai-memory.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.maiagent.ai/maiagent-user-guide/en/start/profile.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
