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. Role-based access control is enforced in the open source edition; on Cloud and Enterprise it follows the plan (non-RBAC plans grant full access). 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. On a plan without RBAC, every member can create, rename and delete projects.

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 (role selection is hidden on Cloud and Enterprise plans without RBAC, where all members get full access)
  5. Send the invitation

Roles​

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

RoleSummary
OwnerFull control of the organization, including billing and member management
AdminManage workspace settings, members, and roles
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 can change roles through the API. Roles change only through the API for now; the app has no control for it yet.

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.

On this page