Teams

What this is

Teams are named groups of account members that you use to grant workspace access in bulk. A team maps to one or more workspaces with a chosen role (viewer, editor, or admin). When you add a user to a team, they get access to every workspace the team is granted on. There are two team types: system teams (fixed, managed by the platform) and custom teams (created and managed by account owners or team admins).

Where to find it

Left navigation → Account → Teams (/account/teams)

The Teams page is in the collapsible Account group at the bottom of the left navigation sidebar.

Teams list

The Teams list is a table of every team in the account, with search, filters, and pagination. Each row shows the team name (editable inline for custom teams with rename permission), the member count, and a Members button to open the team detail panel.

What the teams list shows

Column	Description
Team	Team name with an inline rename control (custom teams only). Badged System or Custom.
Members	Count of members currently in the team.
(Actions)	Members button. Opens the team detail panel for membership and workspace grants.

Filters

Search: type to filter by team name (debounced, client-side).
Type: filter to All, System, or Custom teams.
Pagination: 5 teams per page; move between pages with Previous / Next.

How to use the teams list

Navigate to Account → Teams in the left nav. The teams table loads immediately.
Use the Search field to find a team by name.
Use the Type filter to show only system or custom teams.
Click Members on any row to open the team detail panel (membership + workspace grants).
To rename a custom team, click the edit icon on the team name cell and type the new name. Press Enter or click the confirm button to save.

Creating a team

You can only create custom teams on this page. The platform manages system teams, and users cannot create or delete them.

How to create a team

Click Create team in the page header. A dialog opens.
Enter a Name (required), e.g. “Reliability” or “Platform”.
Optionally enter a Description: a short purpose statement shown in the detail panel.
Click Create. The new team appears in the list and a toast confirms creation.

Team membership

Click Members on any team row to open the team detail panel. This drawer/dialog shows the team’s members, their roles, and (for custom teams) the workspace access grants.

Member list

The member list shows every user currently in the team with their:

Display name and email
Team role: team member or team admin (displayed as “Team member” / “Team admin”)

How to manage team membership

Open the team detail panel by clicking Members on the team row.
Promote a member to team admin: click Make admin next to the member. The role updates immediately.
Demote a team admin to member: click Demote next to the member.
Remove a member from the team: click Remove and confirm the dialog. This removes the user from the team only; they stay a member of the account. To remove them from the account, use Members & invites.

Workspace access grants

You can grant a custom team access to one or more workspaces with a chosen role. The Workspace access panel in the team detail dialog shows the current grants, and team admins can add, change, or remove them there.

How workspace grants work

Each grant is a pair: (workspace, role). The available workspace roles are:

Role	What it allows
Viewer	Read-only access: view tests, runs, and results in the workspace.
Editor	Read-write: create and edit tests, manage projects and secrets, trigger runs.
Admin	Full workspace control: manage members, rename the workspace, and edit all resources.

A team member inherits the workspace role through the team. A team admin inherits the same workspace role, not a higher one, because workspace roles are separate from team roles.

How to manage workspace grants

Open the team detail panel for a custom team.
The Workspace access section shows current grants: workspace name and current role.
Change a grant role: use the role dropdown next to the workspace name.
Remove a grant: click Remove next to the workspace row.
Add a new grant: select a workspace from the Add workspace dropdown and choose a role, then click Add workspace grant.
Click Save workspace grants to save all changes. A toast confirms success.

Tips & gotchas

System teams cannot be renamed, created, or deleted. Only the platform manages system team membership (e.g. the Owners team). Users manage custom teams.
Team role vs workspace role are separate. A user’s role within the team (team_member / team_admin) controls who can manage the team. The workspace role (viewer / editor / admin) controls what they can do inside a workspace. The two are independent.
Multiple grant paths. A user may get workspace access from several sources: direct workspace assignment (set by workspace admins) and one or more team grants. Their effective role is the most permissive one.
Create team button disabled? You need account owner or team admin on the Owners team. Hover over the button to see the requirement in a tooltip.
Pagination. The teams list paginates at 5 teams per page. Use the search filter to find a team quickly when the list is long.

Account overview & active runs: how accounts, workspaces, and teams relate to each other.
Members & invites: invite users to the account and see the member directory.
Workspaces: the workspace detail page, whose Access section shows team grants.
Account overview & active runs: account-level overview and your effective access summary.