Advanced Features6 min read

User Management

Manage your team with Organizations, Projects, user roles, and permissions for secure collaboration.

User Management

AngenAI uses Organizations and Projects to structure teams and control access. This guide covers user roles, permissions, and team management.

Organization Structure

Organizations

An Organization is the top-level container for your AngenAI usage:
  • Contains one or more Projects
  • Has its own team of members
  • Manages billing and subscriptions
  • Has a unique URL identifier (slug)

Projects

Projects exist within Organizations:
  • Represent individual codebases or applications
  • Have their own Source Folder configuration
  • Can have project-specific members
  • Contain Work Items, Media, and project-scoped content

Hierarchy

Organization (e.g., "Acme Corp")
├── Project A (e.g., "Web App")
│   ├── Work Items
│   ├── Media Library
│   └── Project-scoped Knowledge/Personalities/Meetings
├── Project B (e.g., "Mobile App")
│   └── ...
└── Organization-wide Knowledge/Personalities/Meetings

User Roles

AngenAI has four user roles with different permission levels:

Owner

Full control over the organization.
Permissions:
  • All Admin permissions
  • Delete the organization
  • Transfer ownership
  • Manage billing and subscriptions
Each organization has exactly one Owner. Ownership can be transferred to another Admin.

Admin

Manage the organization and its members.
Permissions:
  • All Member permissions
  • Invite and remove members
  • Change member roles (except Owner)
  • Create and delete projects
  • Create and modify organization-wide content
  • Manage organization settings

Member

Standard access for team members.
Permissions:
  • All Viewer permissions
  • Create and manage Work Items
  • Create project-scoped Knowledge, Personalities, and Meetings
  • Upload to Media Library
  • Apply generated code to projects
Limitations:
  • Cannot create or modify organization-wide content
  • Cannot invite or manage other members
  • Cannot create or delete projects

Viewer

Read-only access.
Permissions:
  • View Work Items and their generated code
  • View Knowledge, Personalities, and Meetings
  • View Media Library
Limitations:
  • Cannot create or modify any content
  • Cannot generate code
  • Cannot apply changes

Managing Members

Inviting Members

  1. Go to Settings > Organizations
  2. Select your organization
  3. Click the Members tab
  4. Click Invite Member
  5. Enter the email address
  6. Select a role (Admin, Member, or Viewer)
  7. Click Send Invitation
The invitee receives an email with a link to join your organization.

Pending Invitations

View and manage pending invitations:
  1. Go to Settings > Organizations > Members
  2. See the Pending Invitations section
  3. Cancel invitations if needed

Changing Member Roles

  1. Go to Settings > Organizations > Members
  2. Find the member in the list
  3. Click the role dropdown
  4. Select the new role
  5. Confirm the change
Note: Only Owners can change Admin roles. Admins can change Member and Viewer roles.

Removing Members

  1. Go to Settings > Organizations > Members
  2. Find the member to remove
  3. Click Remove
  4. Confirm removal
Removed members immediately lose access to the organization and all its projects.

Content Scope Permissions

Different roles have different access to content based on scope:
Content TypeOrganization-WideProject-Scoped
ViewAll rolesAll roles
CreateOwner, AdminOwner, Admin, Member
EditOwner, AdminOwner, Admin, Member (own content)
DeleteOwner, AdminOwner, Admin, Member (own content)
Move to OrgOwner, AdminOwner, Admin

Organization-Wide Content

Only Owners and Admins can:
  • Create Knowledge articles at organization level
  • Create Personalities at organization level
  • Create Meetings at organization level
  • Move content from project to organization scope

Project-Scoped Content

Members can:
  • Create content within projects
  • Edit their own content
  • Delete their own content
Admins and Owners can edit and delete all project content.

Project Access

Project Membership

By default, all organization members can access all projects. Project-specific restrictions can be configured if needed.

Source Folder Access

Each user configures their own Source Folder path for projects. This allows:
  • Different team members to have code in different locations
  • Local development environments on different machines
  • Personal folder structures
Note: Source Folder paths are stored per-user and not shared with the team.

Team Setup Best Practices

Small Teams (2-5 people)

  • One Owner (typically team lead)
  • All others as Members
  • Use organization-wide content for shared standards

Medium Teams (5-20 people)

  • One Owner
  • 1-2 Admins for team management
  • Most as Members
  • Consider Viewer role for stakeholders who need visibility

Large Organizations (20+ people)

  • One Owner
  • Multiple Admins across different areas
  • Members for active developers
  • Viewers for managers, QA, or external stakeholders
  • Separate projects for different teams or applications

Role Assignment Guidelines

RoleAssign To
OwnerTeam lead or organization creator
AdminTech leads, senior developers, team managers
MemberActive developers, contributors
ViewerStakeholders, QA (read-only), temporary access

Organization Settings

General Settings

Access via Settings > Organizations:
  • Organization name
  • URL slug (read-only after creation)
  • Description

Billing

Owners access billing settings to:
  • View current plan
  • Upgrade or downgrade subscription
  • Update payment information
  • View usage and invoices

Project Settings

General Settings

Access via Settings > Projects:
  • Project name
  • Description
  • Source Folder path (per-user)

Project Deletion

Only Owners and Admins can delete projects:
  1. Go to Settings > Projects
  2. Select the project
  3. Scroll to Danger Zone
  4. Click Delete Project
  5. Confirm by typing the project name
Warning: Deleting a project removes all Work Items, Media, and project-scoped content. This cannot be undone.

Security Considerations

Access Control

  • Review member list regularly
  • Remove access for departed team members promptly
  • Use Viewer role for temporary or limited access
  • Avoid sharing Owner credentials

Content Visibility

  • All organization members can view all content
  • Sensitive information in Knowledge or Meetings is visible to all members
  • Consider what to include in shared content

Source Folder Security

  • Source Folders are local to each user's machine
  • AngenAI does not sync or share source code between users
  • Generated code is stored in AngenAI servers until applied locally

Troubleshooting

Cannot Invite Members

  • Verify you have Admin or Owner role
  • Check if email address is valid
  • Ensure organization hasn't reached member limit

Member Cannot Access Project

  • Verify they're a member of the organization
  • Check their role permissions
  • Ensure they've configured their Source Folder

Cannot Edit Organization Content

  • Verify you have Admin or Owner role
  • Members cannot edit organization-wide content
  • Check if content is organization-scoped or project-scoped

Cannot Delete Content

  • Members can only delete their own project-scoped content
  • Admins and Owners can delete all content
  • Check content scope and ownership

What's Next?