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)
Project creation and visibility depend on your organization role.
Switching Projects
If your organization has multiple projects, use the project switcher in the UI to move between them. Your api keys as well as custom providers and models will differ per project.
Managing Members
Inviting Members
- Navigate to Settings → Members
- Click Invite member
- Enter the email address
- Choose a role (role selection is hidden on Cloud and Enterprise plans without RBAC, where all members get full access)
- Send the invitation
Roles
Roles control what members can do within an organization and its projects:
| Role | Summary |
|---|---|
| Owner | Full control of the organization, including billing and member management |
| Admin | Manage workspace settings, members, and roles |
| Developer | Deploy to environments and manage API keys |
| Editor | Edit prompts, testsets, evaluators, and workflows |
| Annotator | Run evaluations and annotate traces |
| Viewer | Read-only access |
See RBAC for details.
Changing Roles
Owners and Admins can change roles from Settings → Members.
Removing Members
Removing a member immediately revokes access to the organization and its projects.
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. Owners can transfer ownership to another member from organization settings.
How many organizations can I create?
There are no limits but subscriptions and usage are per organization.