Provides a GitHub team resource.

This resource allows you to add/remove teams from your organization. When applied, a new team will be created. When destroyed, that team will be removed.

Example Usage

# Add a team to the organization
resource "github_team" "some_team" {
  name        = "some-team"
  description = "Some cool team"
  privacy     = "closed"

Argument Reference

The following arguments are supported:

  • name - (Required) The name of the team.
  • description - (Optional) A description of the team.
  • privacy - (Optional) The level of privacy for the team. Must be one of secret or closed. Defaults to secret.
  • parent_team_id - (Optional) The ID of the parent team, if this is a nested team.
  • ldap_dn - (Optional) The LDAP Distinguished Name of the group where membership will be synchronized. Only available in GitHub Enterprise.

Attributes Reference

The following attributes are exported:

  • id - The ID of the created team.


Github Teams can be imported using the github team Id e.g.

$ terraform import github_team.core 1234567

© 2018 HashiCorpLicensed under the MPL 2.0 License.