Sign in
enterprise-teams

Create an enterprise team

To create an enterprise team, the authenticated user must be an owner of the enterprise.

post/enterprises/{enterprise}/teams

Path parameters

enterprisestring required

The slug version of the enterprise name.

Request body

namestring required

The name of the team.

descriptionstring nullable

A description of the team.

sync_to_organizations'all' | 'disabled'

Retired: this field is no longer supported. Whether the enterprise team should be reflected in each organization. This value cannot be set.

organization_selection_type'disabled' | 'selected' | 'all'

Specifies which organizations in the enterprise should have access to this team. Can be one of disabled, selected, or all. disabled: The team is not assigned to any organizations. This is the default when you create a new team. selected: The team is assigned to specific organizations. You can then use the add organization assignments API endpoint. all: The team is assigned to all current and future organizations in the enterprise.

group_idstring nullable

The ID of the IdP group to assign team membership with. You can get this value from the REST API endpoints for SCIM.

Response

Response

idinteger required
namestring required
descriptionstring
slugstring required
urlstring uri required
sync_to_organizationsstring

Retired: this field will not be returned with GHEC enterprise teams.

organization_selection_typestring
group_idstring nullable required
group_namestring nullable

Retired: this field will not be returned with GHEC enterprise teams.

html_urlstring uri required
members_urlstring required
created_atstring date-time required
updated_atstring date-time required

Example response

{
  "sync_to_organizations": "disabled | all",
  "organization_selection_type": "disabled | selected | all",
  "group_id": "62ab9291-fae2-468e-974b-7e45096d5021",
  "group_name": "Justice League",
  "html_url": "https://github.com/enterprises/dc/teams/justice-league"
}

Changes