Admin Guide
User management
View and manage all registered users on the platform
View and manage all registered users on the platform, including their roles, quota, groups, and account status. Sign in with an admin account and click “User management” in the left navigation, or go directly to `/console/user`. The web console list page matches the reference design and is still being integrated.
| ID | Username | Status | Remaining / total | Group | Role | Invitation | Actions |
|---|---|---|---|---|---|---|---|
| 1 | admin | Enabled | ∞ / ∞ | default | Admin | — | Disable · Edit · Demote · ··· |
| 2 | demo_user | Enabled | 1200 / 5000 | default | Standard user | Invited by #1 | Disable · Edit · Promote · ··· |
User list example: search and filters, role and status badges, and row actions
Edit a user
Open the edit dialog
- Click “Edit” on a row in the user list
- Or call
GET /api/user/{id}to fetch the details and open the form - To create a user, click “Add user”, which calls
POST /api/user
Update user details
The dialog lets you change the following fields:
| Field | Description |
|---|---|
nickname · Display name | User nickname shown in the list and profile |
username · Username | Sign-in name; can be changed after creation but must stay unique |
password · Password | Required for new users; leave empty when editing to keep it unchanged |
role · Role | Standard user / Admin / Super admin |
group · Group | For example default, vip, or test |
quota · Quota | Total quota limit of the account; combine with used quota to see the remaining amount |
remark · Remark | Note visible to admins only |
The row actions “Promote / Demote” change role, and “Disable / Enable” toggles status; both can also be performed via POST /api/user/{id}/action.
Save changes
- Edit an existing user: click “Save” to call
PUT /api/user/{id} - Create a new user: enter a username and initial password, then call
POST /api/user - Delete a user:
DELETE /api/user/{id}(irreversible, proceed with caution) - Root can reset a user’s 2FA with
DELETE /api/user/{id}/2faand Passkey withDELETE /api/user/{id}/reset_passkey
Search users
Use search
- Search by user ID, username, or display name (nickname) keyword
- Filter by group from the drop-down to show only users in that group
View search results
- Click “Search” to call GET /api/users?keyword=; “Reset” clears the filters and restores the default list
- The list supports pagination; “Refresh” reloads it from GET /api/user/
The list is returned page by page from GET /api/users; adding the keyword parameter performs a search.
List fields
| Column | Field | Description |
|---|---|---|
| ID | id | Unique user identifier |
| Username | username | Sign-in account; must be unique |
| Status | status | Enabled / Disabled; disabled users cannot sign in or call the API |
| Remaining / total quota | quota - used_quota / quota | Available and used quota of the account |
| Group | group | Determines available models and channel routing group |
| Role | role | 1 = standard user, 10 = admin, 100 = super admin |
| Invitation info | inviter_id / aff_code | Inviter ID or referral code source |
- Disable / Enable: Toggles status; a disabled user can no longer sign in, effective immediately
- Edit: Opens the edit dialog to change quota, group, role, and more
- Promote / Demote: Changes role (e.g. standard user ↔ admin)
- More: Delete the user, reset 2FA / Passkey, and more (Root)
To show this in the admin sidebar, go to Profile settings → Sidebar modules and enable sidebar_modules.admin.user. For groups and quota, see Group management and Quota and top-up.