# Team Roles & Permissions Member roles and permissions are are managed at two levels: **Team** and **Project**. Depending on the invitation settings, inviting a user to a team or project may configure both the team role and project access at the same time. - [Managing Project Members](https://docs.apidog.com/managing-project-members-800838m0.md) - [Managing team members](https://docs.apidog.com/managing-team-members-613028m0.md) ## Team Roles and Permissions ### Default Roles and Permissions Apidog offers built-in team roles with predefined permissions designed to cater to various needs. By assigning a role to a team member, you can effectively manage their permissions and access levels within the team. Team-level permissions are primarily organized around built-in roles such as **Team Owner**, **Team Admin**, **Team Member**, and **Guest**.

Resource Category	Resource Name	Permissions	Team Owner	Team Admin	Team Member	Guest
Team Management	Members/Roles	View Team Member details	✅	✅	✅	❌
		Invite Team Members	✅	✅	❌	❌
		Assign/Remove Team Member Roles	✅	✅	❌	❌
		View Project Roles	✅	✅	❌	❌
		Add/Edit/Delete Project Roles	✅	✅	❌	❌
	Team Settings	Edit Team Name	✅	✅	❌	❌
		Transfer Team	✅	❌	❌	❌
		Dismiss Team	✅	❌	❌	❌
	Project Operations	Create New Projects	✅	✅	❌	❌
		Clone a Project	✅	✅	❌	❌
		Delete/Transfer a Project	✅	✅	❌	❌
		Edit Project Name	✅	✅	❌	❌

:::info[] Custom permissions for team roles are **not yet supported**. ::: ### Setting Team Permissions Set team-level permissions by assigning a team role in member settings, or when sending an invitation if role configuration is available in the invitation flow. ![setting-team-roles.png](https://api.apidog.com/api/v1/projects/544525/resources/349168/image-preview) ## Project Roles and Permissions ### Default Roles and Permissions Apidog provides built-in project roles such as **Admin**, **Editor**, **Read-only**, and **Forbidden**. Depending on your workspace configuration and role settings, additional project role options may also be available. Below is a detailed breakdown of the permissions for each role.

Default Roles and Permissions Table

Resource Category	Resource Name	Permissions	Admin	Editor	Read-only	Forbidden
Branch Management	Sprint Branch	View, Switch Branches	✅	✅	✅	❌
		Merge Branches	✅	✅	❌	❌
		View/Submit Merge Request	✅	✅	❌	❌
		Add, Delete, Modify, Merge Protected Branch Content	✅	❌	❌	❌
	API Versions	View, Switch API Versions	✅	✅	✅	❌
Endpoint Management	Endpoints (including Cases, Markdown, WebSocket, API Documentation, etc.)	View, Run Endpoints	✅	✅	✅	❌
		Add, Delete, Modify Endpoints	✅	✅	❌	❌
		Generate Code	✅	✅	❌	❌
		Add, Delete, Modify Cases	✅	✅	❌	❌
	Schemas	View, Reference Schemas	✅	✅	✅	❌
	Schemas	Add, Delete, Modify Schemas	✅	✅	❌	❌
	Components	View, Reference Components	✅	✅	✅	❌
	Components	Add, Delete, Modify Components	✅	✅	❌	❌
	Requests	View, Send Requests	✅	✅	✅	❌
	Requests	Add, Delete, Modify Requests	✅	✅	❌	❌
	Trash	View	✅	✅	❌	❌
		Restore	✅	✅	❌	❌
		Permanently Delete	✅	❌	❌	❌
Automated Tests	Test Scenarios	View, Run Functional Tests	✅	✅	✅	❌
		Run Performance Tests	✅	✅	✅	❌
		Add, Delete, Modify	✅	✅	❌	❌
		Export to External Programs	✅	✅	❌	❌
	Scheduled Tasks	View/Run Now	✅	✅	✅	❌
	Scheduled Tasks	Add, Delete, Modify	✅	✅	❌	❌
	Test Reports	Delete	✅	✅	❌	❌
Environment Management	Global Variables	View, Edit Current Values	✅	✅	✅	❌
	Global Variables	Add, Delete, Modify	✅	✅	❌	❌
	Global Params	View	✅	✅	✅	❌
	Global Params	Add, Delete, Modify	✅	✅	❌	❌
	Vault Secrets	Add, Delete, Modify, Fetch	✅	✅	❌	❌
	Environments	View, Edit Current Values	✅	✅	✅	❌
	Environments	Add, Delete, Modify	✅	✅	❌	❌
Documentation Sharing	Quick Share	View	✅	✅	✅	❌
	Quick Share	Add, Delete, Modify	✅	✅	❌	❌
	Publish Doc Sites	View, Preview	✅	✅	✅	❌
	Publish Doc Sites	Publish Settings	✅	❌	❌	❌
Project Settings	Basic Settings	View	✅	✅	✅	❌
		Modify	✅	❌	❌	❌
		Clone Project	✅	❌	❌	❌
	Member Management	View	✅	❌	❌	❌
		Add	✅	❌	❌	❌
		Assign/Remove Member Roles	✅	❌	❌	❌
	Feature Settings	View	✅	✅	✅	❌
	Feature Settings	Add, Delete, Modify	✅	❌	❌	❌
	Notification Targets	View	✅	✅	✅	❌
	Notification Targets	Add, Delete, Modify	✅	✅	❌	❌
	Notification Events	View	✅	✅	✅	❌
	Notification Events	Add, Delete, Modify	✅	✅	❌	❌
	Common Parameters	View, Reference	✅	✅	✅	❌
	Common Parameters	Add, Delete, Modify	✅	✅	❌	❌
	Sprint Branches	View	✅	✅	✅	❌
	Sprint Branches	Add, Delete, Modify, Protect, Archive, Restore	✅	✅	❌	❌
	API Versions	View	✅	✅	✅	❌
	API Versions	Add, Delete, Modify	✅	✅	❌	❌
	Public Scripts	View, Reference	✅	✅	✅	❌
	Public Scripts	Add, Delete, Modify	✅	✅	❌	❌
	Database Connections	View, Reference	✅	✅	✅	❌
	Database Connections	Add, Delete, Modify	✅	✅	❌	❌
	Custom Functions	View, Reference	✅	✅	✅	❌
	Custom Functions	Add, Delete, Modify	✅	✅	❌	❌
	Import Data	Manual Import	✅	✅	❌	❌
		Scheduled Import (Manual Trigger)	✅	✅	❌	❌
		Scheduled Import Settings	✅	❌	❌	❌
	Export Data	Export data	✅	✅	❌	❌
Request History	Local Request History	View	✅	✅	✅	❌
	Local Request History	Share	✅	✅	✅	❌
	Shared Request History	View	✅	✅	✅	❌
	Shared Request History	Delete	✅	✅	❌	❌

Project access can be configured not only in project member settings, but also during invitation flows, depending on the available invitation options. ### Setting Project Permissions 1. When sending an invitation, you can specify the project role and, depending on the invitation flow, also configure the team role and additional project permissions. - Via Team Invitation ![image.png](https://api.apidog.com/api/v1/projects/544525/resources/375109/image-preview) - Via Project Invitation ![image.png](https://api.apidog.com/api/v1/projects/544525/resources/375111/image-preview) :::info If you are a Project Admin but **not** a Team Admin, you will not have the permission to customize their `Team Role` or their access to `Other Projects`. ::: ![image.png](https://api.apidog.com/api/v1/projects/544525/resources/375121/image-preview) 2. Alternatively, set project-level permissions via **My Team** → **Members** → **Project Role**. ![Team Permissions Settings](https://assets.apidog.com/uploads/help/2023/07/12/88ceafb35503323b0debd1b358ce8d1a.png) ## Custom Roles and Permissions The **Roles and permissions** feature allows you to customize permissions for specific roles, ensuring they align with the needs of users in various scenarios. Currently, this feature supports custom configurations for project roles only. Customization for team or organization roles is not yet available. ### Customizing Project Roles If the built-in project roles in Apidog don't meet your specific needs for permission control, you can create custom project roles to address this gap. :::info[] This feature is available on [Apidog Enterprise plan](https://apidog.com/pricing/). ::: To create a custom project role, navigate to the **Team → Members → Roles and permissions** or **Organization → Members → Roles and Permissions**. Click **+ Add** to start creating a custom project role. ![add-team-members-project.png](https://api.apidog.com/api/v1/projects/544525/resources/349329/image-preview) You can freely set the custom role name, and then select the desired project permissions for it. ![customizing-project-roles.png](https://api.apidog.com/api/v1/projects/544525/resources/349169/image-preview) **Important Notes:** 1. If you check the "All Permissions" option for a specific module, any new features added to that module will automatically be assigned to the custom role. 2. Default roles (such as Editor or Read-only) cannot be renamed or edited. However, you can copy these roles and modify them to quickly create a new custom role. ## Invitation Configuration When inviting users to a team or project, the inviter's own team role determines what configuration options are available: - **Team Admin and above** can configure: - Team role for the invitee - Permissions for other projects (beyond the current project) - **Team Members** can only configure: - Project role for the current project By default, a user invited via project invitation is assigned the Team Member role at the team level.