provider enterprise-teams POST /enterprises/{enterprise}/teams
@utdk/github /enterprises/{enterprise}/teams
Create an enterprise team
To create an enterprise team, the authenticated user must be an owner of the enterprise.
enterprise path required
The slug version of the enterprise name.
string

Try it

Authentication
Configure credentials for GitHub v3 REST API
enterpriseTeams.create
POST/enterprises/{enterprise}/teams
To create an enterprise team, the authenticated user must be an owner of the enterprise.

Parameters

required

The slug version of the enterprise name.

Input

required

The name of the team.

A description of the team.

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

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](https://docs.github.com/rest/enterprise-teams/enterprise-team-organizations#add-organization-assignments) endpoint. `all`: The team is assigned to all current and future organizations in the enterprise.

The ID of the IdP group to assign team membership with. You can get this value from the [REST API endpoints for SCIM](https://docs.github.com/rest/scim#list-provisioned-scim-groups-for-an-enterprise).

The notification setting the team is set to. The options are: * `notifications_enabled` - team members receive notifications when the team is @mentioned. * `notifications_disabled` - no one receives notifications. Default: `notifications_enabled`

Configure credentials above to enable sending.

Code snippet
Updates live as you fill in the form above.

TypeScript

import github from '@utdk/github';

await github.enterpriseTeams.create({
  "sync_to_organizations": "disabled",
  "organization_selection_type": "disabled"
})