Skip to main content
Version: v2.0

Organizations & Projects

Agenta organizes work around organizations and projects.

Hierarchy​

Organization
└── Project(s)
└── Resources (prompts, evaluations, traces, etc.)
  • Organization: Where team members, billing, and access policies reside
  • Projects: Where you build and operate your LLM apps (prompts, evaluations, observability)

Organizations​

Creating an Organization​

Organizations are created during signup or from the organization switcher. This applies to Agenta Cloud and to self-hosted deployments of both editions; self-hosters can restrict who creates organizations with AGENTA_ACCESS_ALLOWED_OWNER_EMAILS. Roles apply in every edition and on every plan. Domain verification and SSO remain Enterprise features.

Switching Organizations​

If your user account is part of multiple organizations, use the organization switcher in the UI to move between them. Your role and permissions can differ per organization.

Projects​

Projects live inside an organization and contain:

  • Prompt and configuration assets
  • Evaluation artifacts (test sets, runs, results)
  • Observability data (traces/spans)

Who sees a project depends on the edition. In the open source edition, every organization member is a member of every project, with their organization role. On Agenta Cloud and Enterprise, a member sees the projects where they have a project membership. A new project adds every organization member with their organization role.

Creating and renaming a project needs the Owner or Admin role. Deleting a project needs the Owner role.

Switching Projects​

If your organization has multiple projects, use the project switcher in the UI to move between them. Each project has its own API keys, custom providers and models. An API key acts only in its own project.

Managing Members​

Inviting Members​

  1. Navigate to Settings → Members
  2. Click Invite member
  3. Enter the email address
  4. Choose a role. The open source edition, Hobby and Pro offer Admin and Member. Business and Enterprise offer every role except Owner
  5. Send the invitation

Roles​

Roles control what members can do within an organization and its projects:

RoleSummary
OwnerFull control of the organization, including deleting projects and transferring the organization
AdminManage members, roles, projects and billing
MemberUse and build agents, chats and automations, without access to traces, analytics or evaluations
DeveloperDeploy to environments and manage API keys
EditorEdit prompts, testsets, evaluators, and workflows
AnnotatorRun evaluations and annotate traces
ViewerRead-only access

See RBAC for details.

Changing Roles​

Owners and Admins change a role in Settings → Members, in the member's Role column. The owner's role changes only by a transfer of the organization.

Removing Members​

Removing a member immediately revokes access to the organization and its projects.

Schedules, subscriptions and evaluations that run as the removed member stop at their next run.

Billing​

Billing, subscription management, and usage tracking are linked to the organization.

Access Policies​

Organizations can configure:

  • SSO providers (Business and Enterprise)
  • Verified domains (Business and Enterprise)

Troubleshooting​

Can't access an organization​

Common causes:

  • You're signed in with a different email than the one invited
  • The organization requires SSO and you haven't completed SSO sign-in
  • Your invitation expired

Can't invite members​

Common causes:

  • You don't have permission (need Owner or Admin)
  • You've reached member limits on your plan

FAQ​

Can I belong to multiple organizations?​

Yes. You can switch between organizations from the organization switcher.

Can I transfer ownership?​

Yes. The owner can transfer ownership to another member from organization settings. The two of you swap roles in the organization, its workspace, and every project. The new owner also becomes owner of every project where they had no role. Only a transfer moves the Owner role: changing a role or removing a member never makes someone owner, changes the owner's role, or removes the owner.

How many organizations can I create?​

There are no limits but subscriptions and usage are per organization.