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

Managing Team Members

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	✅	✅	❌	❌

Custom team roles are available on the Apidog Enterprise plan. See Custom Roles and Permissions for details.

About the Guest Role

Guest is a restricted team role for members who do not currently need project access.

Guests cannot view the member list or role and permission settings under My Team → Members. They can still edit their own My Nickname in Team Settings.

Changing a member to Guest resets their access to all existing team projects to Forbidden.

Changing them back to another team role does not restore previous project access. An administrator must assign project roles again.

For new projects, Guests are assigned Forbidden by default, regardless of Other Members' Project Permissions. Ask an administrator to grant access after the project is created.

Guest is a team-level role, while Forbidden is a project-level access state.

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.

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

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

Via Project Invitation

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.

Alternatively, set project-level permissions via My Team → Members → Project Role.

Custom Roles and Permissions

The Roles and permissions feature allows you to create custom Team and Project roles when the built-in roles do not meet your permission requirements.

This feature is available on the Apidog Enterprise plan.

Customizing Team Roles

To create a custom team role, navigate to Organization → Members → Roles and Permissions. Under Team Roles, click + Add.

Set the custom role name and select the required team permissions.

Built-in team roles cannot be edited directly.

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.

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.

You can freely set the custom role name, and then select the desired project permissions for it.

Important Notes:

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.

Default project 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.

Team Roles & Permissions

Team Roles and Permissions#

Default Roles and Permissions#

About the Guest Role#

Setting Team Permissions#

Project Roles and Permissions#

Default Roles and Permissions#

Setting Project Permissions#

Custom Roles and Permissions#

Customizing Team Roles#

Customizing Project Roles#

Invitation Configuration#

Team Roles and Permissions

Default Roles and Permissions

About the Guest Role

Setting Team Permissions

Project Roles and Permissions

Default Roles and Permissions

Setting Project Permissions

Custom Roles and Permissions

Customizing Team Roles

Customizing Project Roles

Invitation Configuration