Users
Invite teammates and manage organization membership.
The Users page lists every console member and every pending invite for your organization. Use it to bring new operators in, change their roles, and remove people who have left.

The Users list: each member with their role, Active status and last activity, plus the segment filters and the Invite User button.
Before you start#
- Opening Settings → Users needs
users:view. Every built-in role has it. - Invite User needs
users:invite. Edit user needsusers:update. Remove user needsusers:remove. - Under the built-in roles, Owner and Admin can invite and edit. Only Owner can remove users, assign the Owner role, or change an existing owner.
- Console roles control what someone can do in the console. They do not grant access to private services. Use Access policies for that.
Invite a teammate#
- Open Settings → Users and choose Invite User.
- On Invite teammate, enter an optional Name. It pre-fills their display name when they join.
- Enter the Email (required).
- Pick a Role. The list excludes Owner. The hint reads “Owner role can be assigned after the user joins.”
- Choose Send invite.

Invite teammate: an optional name, the required email, and a role picker that leaves out Owner.
You should see “Invite sent to …” and return to the list. The invite appears as a row named Pending invite with the role in the sub-label and status pending. If the address already has a PulseHA account, the control plane sends a magic-link email instead of a sign-up invite. The invite record is still created.
The recipient opens the link, sets a password on Set your password if they are new, and the pending invite is accepted automatically. Existing users land in the console directly.
Change a name or role#
- On Settings → Users, open the row’s action menu and choose Edit user.
- On Edit user, change Name or Role. Email is disabled with the note “Email can’t be changed here.”
- Choose Save changes.

Edit user: change the name or role. The email field is disabled.
If you are not an owner, the Owner option is absent and the hint reads “Only owners can assign the Owner role.” You cannot demote yourself from Owner.
Remove a user or revoke an invite#
- Open the row’s action menu.
- For a member, choose Remove user and confirm Remove. For a pending invite, choose Revoke invite and confirm Revoke.
Removing a user also revokes that user’s enrolled devices before the profile is deleted. The control plane does this so no ownerless device keeps network access. Check the user’s devices under Network → Devices first if you want to reassign anything. Only pending invites can be revoked.
Filter and export#
Use the All, Admins, Members and Pending segments and the search box above the table. Admins and Members show active users only. Pending shows invites. The export menu downloads the current rows as CSV.
Reference#
Table columns: Name, Email, Role, Status, Last Activity.
| Status | Meaning |
|---|---|
| Active | A member with a profile in the tenant. |
pending | Invite sent, not yet accepted. Can be revoked. |
accepted | Invite accepted. The person now appears as a user. |
revoked | Invite withdrawn. The link no longer grants access. |
Row actions for a user: View activity, Copy email, Edit user, Remove user. For an invite: Copy email, Revoke invite.
| Permission | Built-in roles | Gates |
|---|---|---|
users:view | Owner, Admin, User, Readonly | Opening the page |
users:invite | Owner, Admin | Invite User, Revoke invite |
users:update | Owner, Admin | Edit user |
users:remove | Owner | Remove user, assigning or changing Owner |
Troubleshooting#
- “an invite is already pending for this email”. Revoke the existing invite first, or wait for the person to accept it.
- “failed to send invite”. The authentication service rejected the address. Check the spelling and try again.
- The recipient says the link does not work. They land on the login page with an “invite expired” error when the link cannot establish a session. Revoke the pending invite and send a new one.
- “only owners can manage owner role” or “cannot remove owner”. You are an Admin acting on an Owner. Ask an owner to make the change.
- “cannot demote yourself from owner” or “You cannot remove yourself”. Have another owner make the change.
- Invite User or Edit user is missing. Your role lacks
users:inviteorusers:update. The page stays readable. - “Failed to load users.” The control plane call failed. Choose Retry in the banner.