Project roles

For every project you create, you need to specify which Maia users can access it. Each user can be assigned one role within the project:

• Owner
• Contributor
• Viewer

A user's role determines what they can do within that project, as shown in the Role permissions tables below.

Note

Users with the Super Admin role on an account are always granted the Owner role for all projects in that account.

Note

Project roles and environment roles are independent of each other. The permissions granted by your project role do not affect the permissions granted by your environment role, and vice versa.

For example, if you have the Viewer project role and the Contributor environment role, your project role determines what you can do with project variables—you can view them, but you cannot create, update, or delete them. Although you cannot edit project variables due to your project role, your environment role means that you can create, edit, and delete environment overrides for project variables in your environment.

---

Add a user to a project

If you have the Owner role on a project or the Super Admin role on the account, you can add users to that project.

To add a user to a project, and assign them a role:

1. From Your projects, select your project.
2. Navigate to the Access tab.
3. Click Add user.
4. Select a user from the User drop-down.
   • The drop-down displays every user defined in your Maia account. If you want to invite new users to your account, read Manage other users.
   • To filter the list, begin typing a user's name in the field.

5. Select a Project role for the user. Available roles are:

   • Owner
   • Contributor
   • Viewer

   For information on the available roles, read Role permissions.

6. Click Add to add the user.

---

Edit a user's project role

Only users assigned the Owner role on a project can edit other users.

To update a user's project role:

1. From Your projects, select your project.
2. Navigate to the Access tab.
3. To change a user's project role, click the three dots ... for that user and click Edit user.

---

Remove a user from a project

Only users assigned the Owner role on a project can remove other users. When you remove a user, you delete their assigned role and completely revoke their access to the project.

To remove a user:

1. From Your projects, select your project.
2. Navigate to the Access tab.
3. To remove a user from the associated project, click the three dots ... for that user, and click Remove user.

---

Role permissions

The three user roles, Owner, Contributor, and Viewer, have specific permissions for the following features.

Owner role permissions

	Create	View	Update	Delete	Run
Projects	➖	✅	✅	✅	➖
Branches	✅	✅	✅	✅	➖
Environments	✅	✅	✅	✅	➖
Secret definitions	✅	✅	✅	✅	➖
OAuth connections	✅	✅	✅	✅	➖
Network items	✅	✅	✅	✅	➖
Pipelines	✅	✅	✅	✅	➖
Streaming pipelines	✅	✅	✅	✅	✅
Schemas	❌	✅	❌	❌	➖
Project variables	✅	✅	✅	✅	➖
	Commit	Merge	Pull	Reset
Git	✅	✅	✅	✅	➖
	Add	Edit	Remove	View
Users	✅	✅	✅	✅	➖

Contributor role permissions

	Create	View	Update	Delete	Run
Projects	➖	✅	❌	❌	➖
Branches	✅	✅	✅	✅	➖
Environments	❌	✅	❌	❌	➖
Secret definitions	✅	✅	✅	❌	➖
OAuth connections	✅	✅	✅	❌	➖
Network items	✅	✅	✅	❌	➖
Pipelines	✅	✅	✅	✅	➖
Streaming pipelines	✅	✅	✅	✅	✅
Schemas	❌	✅	❌	❌	➖
Project variables	✅	✅	✅	❌	➖
	Commit	Merge	Pull	Reset
Git	✅	✅	✅	✅	➖
	Add	Edit	Remove	View
Users	❌	❌	❌	✅	➖

Viewer role permissions

	Create	View	Update	Delete	Run
Projects	➖	✅	❌	❌	➖
Branches	❌	✅	❌	❌	➖
Environments	❌	✅	❌	❌	➖
Secret definitions	❌	✅	❌	❌	➖
OAuth connections	❌	✅	❌	❌	➖
Network items	❌	✅	❌	❌	➖
Pipelines	❌	✅	❌	❌	➖
Streaming pipelines	❌	✅	❌	❌	❌
Schemas	❌	✅	❌	❌	➖
Project variables	❌	✅	❌	❌	➖
	Commit	Merge	Pull	Reset
Git	❌	❌	❌	✅	➖
	Add	Edit	Remove	View
Users	❌	❌	❌	✅	➖

The tables above use these icons to show the permission levels for each role.

Icon	Permission level	Description
✅	Allowed	A user can perform this action.
❌	Not allowed	A user cannot perform this action.
➖	Not applicable	This permission is not applicable to projects.