Users, roles and administration
Administrators look after accounts, access, organisations and the licence. This page is for them. It also explains what an Organizational Manager can and cannot do.
| Role | What they can do |
|---|---|
| User | Chat, use workspaces they have access to, create files, create their own API keys |
| Organizational Manager | A user who also runs one organisation: its people, its name, its shared workspaces and their documents. Sees only that organisation |
| User Manager | Everything a user can, plus look after the accounts of ordinary users from the Users page |
| Administrator | Everything a user can, plus manage users and other administrators, internet access, organisations, and read the licence page |
| Server administrator | One fixed administrator account, set during installation, with a few extra powers such as installing the licence key and choosing User Managers |
Your server team sets who is an administrator. That can’t be changed in the web app, so no administrator can make another one. The server administrator chooses User Managers on the Users page. An administrator or the server administrator adds people to an organisation and sets who is an Organizational Manager there.
For the full table of who can do what, the server administrator’s role and the suspension rules, see User roles and rights.
User Managers
Section titled “User Managers”A User Manager is a normal user who can also look after accounts, for example someone in HR or at a branch. They see Users in the menu and no other admin page.
To make someone a User Manager, the server administrator opens the person on the Users page and clicks Make User Manager in the Role section. Remove User Manager takes the role away, and it stops working on the person’s next click. An administrator is not made a User Manager, because they can already do more. If you see no Role section, ask your server team to switch the User Manager role on.
What a User Manager can do, for ordinary users only:
- Add people one at a time or from a CSV file, and place a new person in an organisation as a member.
- Reset password or make a New setup link.
- Suspend, archive and reactivate accounts, and clear a person’s chat history.
- Delete the data of an archived account.
- Switch a person’s internet access on or off.
What a User Manager can’t do:
- Change an administrator, the server administrator, another User Manager or their own account.
- Reset the password of an Organizational Manager, or create an account for an administrator’s address.
- Lift a suspension made by the server administrator.
- Open the licence, the organisations or any other admin page.
Two limits stop mistakes from spreading. A User Manager can make up to 50 resets and setup links in 10 minutes and create up to 200 accounts in an hour. Rows in a CSV file count towards the 200, and a file that would go over the limit is refused as a whole. Administrators have no such limit.
Archived accounts count for User Managers
Section titled “Archived accounts count for User Managers”When a User Manager adds people, every account on the server counts towards the server’s user limit, archived accounts included. This stops accounts being created and archived again and again.
- At the limit, + Add user is refused with a message that says what to do. In Import CSV, only as many rows as there are free places are created, and Check file already shows the rows that would go over, with the reason.
- To make room, use Delete data on archived accounts you no longer need (possible 10 minutes after archiving). This removes the account and frees its place. Or ask your server team to raise the limit.
- Administrators and the server administrator keep the usual rule: archived accounts don’t count when they add people. Reactivating an archived account works as before.
- A refused creation is recorded in the audit log.
An administrator can’t change a User Manager’s account or lift a suspension a User Manager made. The server administrator can.
Add people
Section titled “Add people”On the Users page:
- + Add user adds one person, or
- Import CSV adds up to 5,000 rows (1 MB) from a file.
A new person shows as Invited until they open their setup link and set a password. Use the status filter to list everyone who is still invited.
Import from a CSV file
Section titled “Import from a CSV file”- On the Users page, click Import CSV, then Download template. You get
zenithai-users-template.csvwith just the header line. - Fill in one person per row in Excel or any editor, and save it as CSV (in Excel, choose CSV UTF-8).
- Choose the file, or paste it into the box, and click Check file.
- ZenithAI shows how many rows are ready. Rows with a problem are skipped, with the reason. Nothing is created until you click Create users.
- Copy the setup links, or click Download links (CSV). They are shown only once.
| Column | Needed? | Notes |
|---|---|---|
first_name |
Yes | Up to 60 characters |
last_name |
Yes | Up to 60 characters |
email |
Yes | A valid address, used once |
designation |
No | Up to 120 characters |
organisation |
No | Must match an existing, active organisation. The person joins it as a member |
An example row: Asha,Verma,asha.verma@example.com,Manager,. There is no role column: everyone is created
as a user.
Each person gets a one-time setup link, valid for 48 hours by default. They open it and set their own password.
Reset a password or send a new link
Section titled “Reset a password or send a new link”Click a person on the Users page to open their details. The Sign-in section has:
- Reset password for an active account. The person is signed out everywhere and gets a new setup link.
- New setup link for an invited account. The earlier link stops working.
- Change my password on the server administrator’s own row.
A setup link is shown only once, so copy it before you close the window. The same section lists the person’s recent sign-ins, failed sign-ins and API keys.
Suspend, archive or reactivate
Section titled “Suspend, archive or reactivate”- Suspend: the person can’t sign in and their API keys stop working. Nothing is deleted.
- Archive: for people who have left. An administrator, the server administrator or a User Manager can archive.
- Reactivate: brings a suspended or archived account back.
- Delete data: for an archived account, ten minutes or more after archiving. An administrator can do this for
ordinary users, not for another administrator. If a deletion stops part-way, it can be resumed. A chat safety copy,
made when chat history is cleared, can be restored for 7 days. The API responses the person’s keys stored with
store: trueare deleted too.
Suspending and archiving need a reason, which is kept. An administrator can suspend or archive other administrators, but not the server administrator and not themselves. Only the server administrator reactivates another administrator, deletes an administrator’s data or clears an administrator’s chat history. See Roles and rights.
Internet access per person
Section titled “Internet access per person”On the Users page, switch Internet access off for anyone. After you confirm, ZenithAI makes no web searches and opens no web pages for that person, and stops any web jobs they have running. See Web search and internet.
Organisations
Section titled “Organisations”An organisation groups the people who share workspaces, such as a company or a branch network.
Administrators and the server administrator create organisations, rename, archive and restore them, and add people under Users in Organization. They also set who is an Organizational Manager, who can then add and remove people and rename the organisation themselves. Administrators use the same Organisation screens as the server administrator. The one limit is that an administrator can’t change the server administrator’s membership. Archiving an organisation switches off its shared workspaces and removes everyone’s access to them, the server administrator’s too. Documents are kept, and Restore brings it all back.
An administrator or a User Manager can also place a new person in an organisation, in + Add user or
with the organisation column of Import CSV. The person joins as a plain member, never as an Organizational
Manager, so they can use the organisation’s workspaces that are open to everyone. People who
already have an account are not moved.
Whoever creates the account holds its one-time setup link, so every placement is on the record. The person’s Sign-in and account events list on the Users page always shows a line such as Created 10-10-2026 · asha.admin@example.com · organisation Finance. If that record can’t be written, the account is not created.
Organizational Managers
Section titled “Organizational Managers”An Organizational Manager runs the shared workspaces of one organisation. In every other way they are an ordinary user. Once the organisation has at least one workspace, Organisation Knowledge appears in their menu.
An Organizational Manager can, in their own organisation:
- See Users in Organization, with each person’s role.
- Add people: type the full email of someone who already has a ZenithAI account and click Add. They join as a member. The reply is always If an account with this address can be added, it is now a member of this organisation.
- Use the ⋮ menu on a person to Make Organizational Manager or Make member, or Remove from Organization. Removing does not suspend the person’s ZenithAI account. On their own row the choice is Step down to member.
- Rename the organisation: click its name, then Save name in Details and name.
- Create shared workspaces, rename them, and choose who can use each one: Everyone in the organisation or Only selected people. Organizational Managers always have access.
- Add and delete a workspace’s documents and websites from Organisation Knowledge, and open the audit log with View audit.
An Organizational Manager can’t:
- See or change any other organisation.
- Create, archive or restore an organisation, or use Add people, roles, remove or rename while the organisation is archived.
- Change or remove the server administrator, an Admin or a User Manager, remove themselves, or remove or demote the last active Organizational Manager.
- Suspend, reactivate or archive a person’s account, delete their data or clear their chat history. These affect the whole account, not just the organisation, so they belong to administrators.
See User roles and rights for the full detail.
A member uses the shared workspaces they have access to in chat. They see their organisation’s name, Your Organizational Managers and the workspaces they can use, but not the other members. To get access to a workspace, they ask an Organizational Manager.
See Workspaces for how the documents are used in chat.
XgenPlus Mail connector
Section titled “XgenPlus Mail connector”Administrators can offer users the XgenPlus Mail connector, which lets a chat read a user’s XgenPlus mailbox. Open Settings, then Admin, and find the XgenPlus Mail card.
- The XgenPlus Mail for ZenithAI switch is off until you turn it on.
- Under Advanced, Who may use it takes one email per line, or
*for everyone. Click Save. - The server needs its connector key before anyone can connect. The card warns you while it is missing.
- Users sign in with their own XgenPlus agent token. You never see it. The connector is read only.
Audit and usage
Section titled “Audit and usage”- Every account change by an administrator or a User Manager is recorded. If the record can’t be written, the change is refused, so nothing happens off the record.
- Administrators can open a user’s chat log when needed. Every view is recorded too.
- Each person can see their own daily usage on the Chat usage page in Settings. It counts chats in the app. Requests made with an API key are shown with the person’s API keys.
API & Usage page
Section titled “API & Usage page”API & Usage is the administrator’s page for every API key and for who uses ZenithAI the most. Open Settings and choose API & Usage, directly below Admin in the side menu. Only administrators see it; User Managers don’t. It has three tabs: Keys, Usage and Live Snapshot.
Keys tab: every API key
Section titled “Keys tab: every API key”The All API keys list shows every active API key in the organisation, one row per key:
| Column | What it shows |
|---|---|
| Name | The name the owner gave the key |
| Prefix | The first characters of the key, enough to recognise it. Click the copy button to copy them |
| Owner | The person who created the key. Old keys made before owners were recorded show No owner (legacy key) |
| Created | When the key was made |
| Last API use | When the key was last used to call the API. Keys that were never used are always listed last |
| Add docs | Whether the key Can add documents to workspaces (see below) |
To find keys:
- Search by name, owner or prefix. Every word you type must match. Press / to jump to the search box and Esc to clear it.
- Choose one person under All owners.
- Click a filter: Can add documents, Never used or Unused 30+ days. Clear filters removes them. Unused 30+ days is a quick way to find keys you may no longer need.
- Click any column heading to sort by it. Choose Rows 25, 50 or 100 per page.
The list never shows the secret key, the IP addresses a key was used from, or any prompt text. It counts API use only; for use of the app itself, see Last seen on the Users page. On a window narrower than 1,100 pixels each key is shown as a card instead of a table row.
This page does not revoke or delete keys. A key’s owner deletes it under Settings › API keys, and suspending a person stops all their keys at once (see Suspend, archive or reactivate).
Let a key add documents
Section titled “Let a key add documents”API keys are read-only for workspaces: they can list and ask, but not add. To let a key add documents through
the workspace API, turn on its Add docs switch in API & Usage › Keys.
You see Name can now add documents. with an Undo button for 7 seconds. The key can then add files to its
owner’s own personal workspaces, never to shared or organisation workspaces. Adding documents must also be
switched on for the server in its API settings; until it is, the document calls answer 404 api_disabled. Turn
the switch off to make the key read-only again.
Usage tab: Top 10 by usage
Section titled “Usage tab: Top 10 by usage”The Usage tab has the Top 10 by usage card. It lists the ten people who used ZenithAI the most in the chosen period, so you can see who depends on it and plan capacity.
- Choose the period: Today, 7 days or 30 days. The dates are shown under the heading.
- Sort By requests or By tokens.
- Each row shows the person’s email, how their use is split between API, Chat, Workspace and Agents, and their requests and tokens. Hold the pointer on a row to see the last use, and on the tokens to see tokens in and out. Agents counts the AI calls of ZenithAI Agents, including the listening of Note Taker.
- Requests include those that were refused or failed. A row with any of these shows a red N problems label.
- An API key whose owner is not known is listed by its key name, with a no owner mark.
- Three totals are not ranked and are shown in one line under the list: requests refused for an unknown key, and the use of deleted users and deleted keys.
- The numbers can be up to a minute old. Refresh within that minute shows the same numbers.
The card counts from the day usage counting started on your server, so earlier use is not in it. When that day falls inside the chosen period, the card shows Counting since with the date.
Why requests failed
Section titled “Why requests failed”Click the red N problems label on a row to see what went wrong for that person or key. For each reason the window shows a plain sentence, where it happened (for example chat, the API or Agents), how many times, and the first and last time. Typical reasons are a rate limit, a request too large for the tier, or the model server being busy.
- Only the kind of problem is kept. The text of the request or of the answer is never stored.
- Reasons are kept for 35 days, and the window shows up to 30 days. The counts in the card are kept without limit.
- Problems from before reasons were recorded show reason was not recorded.
- The window covers chat, API and Agents AI calls. Note Taker’s own jobs, such as telling speakers apart, and website imports are not in it.
Use it to help a person whose work keeps failing, or to see when a tier needs more capacity.
Live Snapshot tab: the last 10 minutes
Section titled “Live Snapshot tab: the last 10 minutes”Live Snapshot shows what is happening on the server right now. It refreshes every 5 seconds and covers the last 10 minutes:
- Requests, Per minute now, Tokens in, Tokens out, Active users and Problems. Click Active users to see who.
- A chart of requests or tokens per minute, on IST clock time.
- By surface (Chat, API, Workspace, Agents) and By model tier.
The numbers are kept in memory only. After a restart the tab says counting here only since with the time. Research jobs, Excel and Office file building, and stopped answers are not counted here; the Usage tab is the long-term record.
Storage page
Section titled “Storage page”The server administrator sees how the server’s disk is used under Settings › Storage, from the Storage card on the Admin page (Manage storage ›), or from the Disk used figure on Overview. Other administrators don’t see it.
- Disk used, with the guard: when less than 5 GB is free, new chat files are no longer kept.
- Chat attachments: how many files are kept, for how many users, and their size.
- Expiring in the next 30 days, and Free until the guard.
- Where the space goes, by category, with what Can be freed.
- Largest users. Click a person to open their details on the Users page.
- Retention and sweep: the current Attachment Life in Chat, the Daily sweep mode and its last run, and a table that shows what would be kept for other numbers of days.
Refresh updates the figures, at most once a minute.
Storage actions
Section titled “Storage actions”Open Actions to change things. Every action first shows what it would do (Check), then asks you to type a confirmation before Apply:
| Action | What it does | You type |
|---|---|---|
| Expire now | Removes kept attachments older than the current life | expire N files |
| Delete a user’s kept files | Removes one person’s kept attachments. Their chats stay | The person’s e-mail |
| Attachment Life in Chat | How many days attachments are kept, from 0 to 3650. 0 keeps them until the chat is deleted | The number |
| Daily sweep | Counts only (dry run), or On: deletes expired files every day | dry_run or on |
Every change is recorded in the audit log. Deleted files can’t be restored. The default life is 90 days. People see it in the attach menu, for example Files you attach are kept for 90 days. See Chat.
Storage on the Users page
Section titled “Storage on the Users page”The Users table has a Storage column with each person’s kept chat attachments (size and number of files), and a Storage over N MB filter. A person’s details have a Storage section that lists their chats and file names with the first expiry date. Opening it shows file names, so every view is recorded in the audit log.
Internet access is shown as an icon in the table: a green tick for Internet: allowed and a red cross for Internet: blocked.
Common questions
How do I add many users to ZenithAI at once?
Import a CSV file from the admin Users page. One file can hold up to 5,000 rows and be up to 1 MB. Each new person then gets a one-time setup link to set their password.
Can an administrator read users' chats?
Yes. An administrator can open a user's chat log when needed, for example for an investigation. Every such view is recorded in the audit log, so it is never secret. Tell your staff about this in your usage policy.
What happens when I suspend a user?
The person can no longer sign in, and their API keys stop working. Nothing is deleted. You can reactivate the account later. Suspending or archiving needs a reason, which is kept for the record.
Do archived accounts count towards the user limit?
For accounts a User Manager creates, yes. Every account on the server, archived ones included, counts towards the server's user limit. At the limit a User Manager can't add anyone until accounts are deleted or the limit is raised. Administrators don't count archived accounts.
How do I see why a user's requests failed?
On the Admin page, the Top 10 by usage card marks a person with failed or refused requests with a red problems label. Click it to see each reason in plain words, where it happened, how many times, and the first and last time.
How does a ZenithAI administrator see how much disk chat attachments use?
The server administrator opens Settings and then Storage. It shows disk used, the space taken by chat attachments, files that expire in the next 30 days and the largest users. Changes, such as expiring files now or changing how long attachments are kept, are checked first and need a typed confirmation.
What is an Organizational Manager in ZenithAI?
An Organizational Manager runs one organisation. They add existing accounts by email, make people managers or members, remove people from the organisation, rename it, and manage its shared workspaces and documents. They cannot suspend or delete accounts.
What is a User Manager in ZenithAI?
A User Manager is an ordinary user who also looks after accounts. They can add people, reset passwords, and suspend, archive or reactivate ordinary users. They can't change administrators or other User Managers, and they see no other admin pages. Only the server administrator gives or removes this role.
