» github_team

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.
  • slug - The slug of the created team, which may or may not differ from name, depending on whether name contains "URL-unsafe" characters. Useful when referencing the team in github_branch_protection.

» Import

GitHub Teams can be imported using the GitHub team ID e.g.

$ terraform import github_team.core 1234567