Invite members (owner only)
The Invite Members card is visible only to the tenant owner. Other members see the team roster but not the invite controls.- Enter one or more email addresses in the invite form. Use Add another to invite several people at once.
- Click Invite. Each address is added to the tenant via
POST /tenants/users?tenant_id=&email=. - Invited users gain access to all tenant-wide datasets and can sign in to the same workspace.
The person you invite must have signed in to Cognee at least once before they can be added. They don’t need a payment method of their own — workspaces support unlimited users.
- Addresses that already belong to an account are added immediately (“N existing members added”).
- Addresses with no account yet receive an invite email and are recorded as pending (“N invite emails sent — they join automatically when they sign up with that email”). The invite link pre-fills the email field on the sign-up form, and the new user joins the tenant automatically when they sign up with that exact address.
View members
The Members tab lists everyone who has joined the current tenant, fetched fromGET /tenants/{tenantId}/users. Each row shows the member’s avatar, email, and role (Owner or Member). Use the search box to filter by email.
Roles are not yet populated in the UI, so every member currently shows as
Owner or Member. The role filter and text filter exist, but the role filter is scaffolding for now.@cognee.agent are filtered out of the roster.
Pending invitations
Invited addresses that have not signed up yet appear under the Pending Invitations tab (with a count) rather than in the members roster. Each pending row shows a Pending badge and the note “Joins automatically when they sign up with this email.” The tenant owner can revoke a pending invitation from the⋮ menu on the row.
Remove a member (owner only)
The remove (⋮) control next to each row is visible only to the tenant owner. Confirm the prompt to remove a member; the call goes to DELETE /tenants/users?tenant_id=&user_id= and also revokes the member’s role and dataset permissions inside the tenant. The owner cannot be removed.
Switch tenants
If you belong to more than one tenant, the workspace can be switched without signing out. Available tenants are fetched fromGET /api/v1/permissions/tenants/me. Selecting another tenant from the workspace switcher stores the choice in a cognee_selected_tenant cookie (also mirrored to localStorage) and reloads the app against that tenant’s API base URL.
The selected tenant is sticky across page loads. Server actions read the same cookie so management calls (members, billing) target the active tenant.
Tenant membership and ownership are part of the broader permissions model. For the underlying API endpoints, see Permissions & Access Control.