Manage teams

Create teams to organize people and their jobs, update team details, and archive teams that you no longer use. Manage teams in Settings > Teams. To restore an archived team, use the CosmicAC CLI.

Prerequisites

Before you start, make sure that you have what the task requires.

• Create a team: the platform administrator role.
• Edit or archive a team: the team lead role or the platform administrator role.
• Restore a team: the platform administrator role and CosmicAC CLI version 1.3.2 or later, signed in to your deployment. For more information, see Install the CLI.

For details about roles and permissions, see Teams and roles.

Open the team list

1. In the sidebar, click Settings.
2. Click Teams.

The Teams page lists your teams. If you're a platform administrator, the page lists every team in the deployment.

Create a team

1. On the Teams page, click Create team.
2. In the Name field, enter a name that no other active team uses.
3. Optional: in the Description field, enter a description of up to 160 characters.
4. Click Create team.

The new team has no members. To add its first team lead, switch to the new team, and then invite that person. See Manage team members.

Switch your active team

Your active team owns the jobs and API keys that you create.

1. At the top of the sidebar, click the team switcher.
2. Click the team that you want to work in.

The page reloads with that team active.

Edit a team

You can update a team's name and description. A team lead can edit only their active team. A platform administrator can edit any team.

1. If you're a team lead, switch to the team that you want to edit.
2. On the Teams page, in the team's row, click Edit team.
3. Update the Name or Description field.
4. Click Save changes.

Archive a team

Archive a team when you no longer need it.

You can't archive a team that still has jobs, reserved nodes, or members other than you. Suspended members count as members, but you don't need to remove yourself.

Nobody can remove a team's last active team lead. If you're a platform administrator who isn't a member of the team, ask the team lead to archive the team instead.

1. Remove every other member from the team. See Manage team members.
2. Delete the team's jobs.
3. If the team has reserved nodes, ask a platform administrator to clear the reservation. See Clear a team's reservation.
4. On the Teams page, in the team's row, click Archive team.
5. In the Archive team dialog, click Archive team.

If you archive your active team, the web interface reloads and opens your next available team.

Restore an archived team

To make an archived team active again, restore it with the CLI. The web interface doesn't have a restore action.

1. To find the team's ID, list the teams.

   cosmicac teams list

   An archived team has the status team archived.

2. Restore the team. Replace <team> with the team's ID or name.

   cosmicac teams unarchive --team <team>

3. When the CLI asks you to confirm, enter y.

The CLI prints a message with the restored team's name and ID. The team keeps its members and its storage volumes. The team's API keys work again, but revoked and expired keys still don't work. CosmicAC doesn't recreate the pending invitations that it deleted when it archived the team. To invite those people again, see Invite a member.

Restoring a team doesn't change your active team. To work in the restored team, run cosmicac teams use <team> or select the team in the team switcher. For more information, see Switch your active team.

If another active team uses the same name, the CLI returns the error Team name already in use. To fix the error, rename the other team, and then restore the archived team again. For more information, see Edit a team.

Next steps

• Manage team members
• Teams and roles