capabilities.work

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

Idempotently create a team in an organization and read back its details.

  1. Read the organization to confirm the token can reach it and administer its teams.
  2. List the organization's teams so an existing team with the target name is reused rather than duplicated on a rerun.
  3. Create the team with the supplied visibility, since no team with this name exists in the organization yet.
  4. Read the freshly created team back to confirm its visibility setting and starting member count.
  5. 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.