Onboard a Team into an Organization
A 5-step recipe with Terraform. We can help you get access.
Recipe · 5 steps
Onboard a Team into an Organization
with Terraform
Idempotently create a team in an organization and read back its details.
- Read the organization to confirm the token can reach it and administer its teams.
- List the organization's teams so an existing team with the target name is reused rather than duplicated on a rerun.
- Create the team with the supplied visibility, since no team with this name exists in the organization yet.
- Read the freshly created team back to confirm its visibility setting and starting member count.
- Read the already-present team instead of creating a duplicate, reporting its current visibility and member count to the caller.
What you'll need to have ready
- organizationName: The organization the team belongs to.
- teamName: The team name (e.g. "platform-engineering").
- teamVisibility: Team visibility, typically "secret" or "organization".
For your developer
Arazzo workflow terraform:onboard-team, 5 operations: GetOrganization → ListTeams → CreateTeam → GetTeam → GetTeam. Specs on APIs.io.