Organizations

Organizations are the top-level unit for managing team access in aqua. Every project belongs to an organization, and organization membership determines who can view and interact with the projects inside it.

Personal vs Team Organizations

aqua has two types of organizations:

	Personal	Team
Created by	Automatically when you register	Manually from the Web UI
Limit	One per user	Multiple allowed
Members	Owner only	Owner + invited members
Billing plan	Always Free	Free, Team, or Enterprise
Deletable	No	Yes (owner only)

Your personal organization is created during registration and cannot be deleted. It provides a private workspace for individual projects.

Team organizations let you share projects with other users and collaborate on QA plans. Each member is assigned a role that controls what they can do.

Creating a Team Organization

You can create a team organization from the Organizations page in the Web UI:

1. Click New Organization.
2. Enter a name for the organization.
3. Click Create.

You become the owner of the new organization automatically.

Members and Roles

Organization members are assigned one of four roles, listed from most to least privileged:

Role	Description
owner	Full control. Can manage billing, delete the organization, and transfer ownership.
admin	Can invite and remove members, change roles, and manage billing.
member	Can create and execute QA plans, manage projects, and update project memory.
viewer	Read-only access to projects, QA plans, and execution results.

Permissions

Action	Owner	Admin	Member	Viewer
View projects and plans	✓	✓	✓	✓
Create and execute QA plans	✓	✓	✓
Invite members	✓	✓
Change member roles	✓	✓
Promote to owner	✓
Remove members	✓	✓
Rename organization	✓
Manage billing	✓	✓
Delete organization	✓

Inviting Members

To invite a member, go to the Members tab on the organization page:

1. Click Add Member.
2. Enter the email address of the user you want to invite. The user must already have an aqua account.
3. Select a role (Admin, Member, or Viewer).
4. Click Add.

Note

You cannot directly assign the owner role when inviting. To transfer ownership, first add the user with another role, then promote them.

Changing Roles

Admins and owners can change a member’s role from the Members tab by selecting a new role from the dropdown next to their name. Only the owner can promote someone to owner or change the owner’s role.

Removing Members

Admins and owners can remove members by clicking the remove button next to their name on the Members tab. The owner cannot be removed from the organization.

Projects in Organizations

Projects are created through the CLI (aqua-cli init), not from the Web UI. When the CLI sends requests, the server uses the X-Project-Key header to automatically resolve which organization the project belongs to:

• If you are a member of a team organization that already has a project with the same key, it is used.
• Otherwise, the project is created in your personal organization.

Transferring Projects

You can move a project from one organization to another through Project Settings:

1. Open the project’s settings page.
2. In the transfer section, select the destination organization.
3. Confirm the transfer.

You must be a member of the destination organization. All QA plans and execution history move with the project.

Transferring is immediate

Once transferred, the project and all its data belong to the new organization. Access is governed by the destination organization’s membership.

Deleting an Organization

Only the owner can delete a team organization. Personal organizations cannot be deleted.

Deletion is permanent

Deleting an organization removes all its projects, QA plans, execution history, and other data. This action cannot be undone.

To delete an organization:

1. Go to the Settings tab on the organization page.
2. Scroll to the Danger Zone section.
3. Click Delete Organization and confirm.