Teams

What this is

Teams are named groups of account members used to grant workspace access in bulk. A team maps to one or more workspaces with a chosen role (viewer, editor, or admin), so adding a user to a team instantly gives them access to every workspace that 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 searchable, filterable, paginated table of all teams in the account. 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.

Teams list. Search by name, filter by type (All / System / Custom), and paginate through results. Click the Members button to open a team's 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; navigate with Previous / Next controls.

How to use the teams list

1. Navigate to Account → Teams in the left nav. The teams table loads immediately.
2. Use the Search field to find a team by name.
3. Use the Type filter to show only system or custom teams.
4. Click Members on any row to open the team detail panel (membership + workspace grants).
5. 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

Only custom teams can be created from this page. System teams are managed by the platform and cannot be created or deleted by users.

How to create a team

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

Who can create teams?

You must be an account owner or a team admin on the Owners system team to create custom teams. If the Create team button is disabled, hover over it to see the permission requirement.

---

Team membership

Clicking Members on any team row opens the team detail panel — a drawer/dialog showing 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

Team admin required

You need the team admin role on a team to change member roles or remove members. If you see a “View only” notice, ask a team admin to make the change, or contact an account owner.

1. Open the team detail panel by clicking Members on the team row.
2. Promote a member to team admin — click Make admin next to the member. The role updates immediately.
3. Demote a team admin to member — click Demote next to the member.
4. Remove a member from the team — click Remove and confirm in the confirmation dialog. This removes the user from the team only — they remain a member of the account. To remove them from the account entirely, use Members & invites.

System team membership

System team membership is managed by the platform (e.g. the Owners team is automatically populated from account owner roles). The Members panel shows a note explaining this for system teams.

---

Workspace access grants

Custom teams can be granted access to one or more workspaces with a chosen role. The Workspace access panel inside the team detail dialog shows the current grants and lets team admins add, change, or remove them.

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 their membership in the team. A team admin also inherits the workspace role (not an elevated one — workspace roles are separate from team roles).

How to manage workspace grants

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

Grant changes are immediate for new runs

Saving workspace grants takes effect immediately. Members of the team gain or lose workspace access for all new operations. In-progress runs are not interrupted.

---

Tips & gotchas

• System teams cannot be renamed, created, or deleted. Only the platform manages system team membership (e.g. the Owners team). Custom teams are fully user-managed.
• 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 — these are independent.
• Multiple grant paths. A user may have workspace access from multiple sources: direct workspace assignment (set by workspace admins) and one or more team grants. Their effective role is the most permissive one across all sources.
• Create team button disabled? You need account owner or team admin on the Owners team. Hover over the button to see the tooltip explaining the requirement.
• Pagination. The teams list paginates at 5 teams per page. Use the search filter to find a team quickly when the list is long.

---

Related docs

• Accounts, workspaces, and projects — how accounts, workspaces, and teams relate to each other.
• Members & invites — invite users to the account and see the member directory.
• Workspaces — workspace detail page, where team grants are reflected in the Access section.
• Account overview & active runs — account-level overview and your effective access summary.