Importing and exporting teams and users

When you stand up a new environment, or mirror a staging setup into production, you rarely want to rebuild your teams and their people one at a time. The Teams admin page can export your teams and users to a portable file and import that file elsewhere, so a whole structure moves in one step.

Export

1. Go to Admin to Teams.

2. Select Export. Ajutant downloads a portable file (YAML or JSON) describing your teams and their members.

3. Keep the file somewhere safe. It is a snapshot: re-export whenever the structure changes.

Import

1. In the target environment, go to Admin to Teams and select Import.

2. Choose the exported file. Ajutant reads the teams and users it contains.

3. Review what will be created or updated, then confirm.

Note

Import moves the structure (teams, their members, and roles), not secrets. People still sign in through your identity provider in the target environment, so make sure the same accounts exist there. Review the summary before you confirm, especially when importing into an environment that already has teams.

When to use it

• Standing up a new environment with your existing team layout in place from day one.
• Bulk onboarding a set of people and teams rather than adding them individually.
• Keeping environments aligned, for example mirroring a staging structure into production.

For day-to-day changes to a single team or person, edit them directly, see Users, teams, and roles.