Skip to main content

Create a team

A team is just a name and a description. Members and shared projects get added once the team exists.

  1. Open the Teams tab and click Create Team.
Teams page with the Create Team button in the headerTeams page with the Create Team button in the header
  1. Enter a Name. A description is optional and editable later.
Create Team modal with the Name and Description fieldsCreate Team modal with the Name and Description fields
  1. Click Create Team. The new team appears in the list with an empty Members tab and empty Projects tab.
Newly created team in the Teams listNewly created team in the Teams list

Edit a team​

What changesWhere
NameClick the edit (pencil) icon in the team header.
DescriptionSame edit modal.
MembersThe Members tab — see Invite members.
ProjectsThe Projects tab — see Share a project.
Selected team showing the edit iconSelected team showing the edit icon

Edit the fields and click Update Team.

Edit Team modalEdit Team modal

Delete a team​

Deleting a team revokes every member's team-based project access in one step. The team's members keep their account membership; the projects themselves are untouched. The action requires you to type the team name to confirm.

  1. Click the actions menu (three dots) on the team row and choose Delete.
Team row actions menu with Delete highlightedTeam row actions menu with Delete highlighted
  1. Type the team name to confirm, then click Delete.
Delete confirmation modalDelete confirmation modal

Honest limits​

  • Team names should be unique within an account. The API doesn't currently reject a duplicate, but the console relies on names being distinguishable in lists and search. Pick something the team will still answer to in six months.
  • Delete is irreversible. There's no soft-delete or restore for teams. If you delete a team, recreating it with the same name does not restore its member list or shared projects — you re-add both.
  • Owner-only sensitive actions. Only an account Owner or Admin can delete a team. Members can create teams they own but can't delete teams they didn't create.
  • No transfer of ownership today. The owner_id on a team reflects who created it. There's no in-product flow to reassign ownership when that person leaves the account; contact support if you need this.

What's next​