v56

latestOpenAPI 3.0.3MITraw.githubusercontent.com2026-08-011,4581,08113.3 MB
teams

Create or update IdP group connections

Creates, updates, or removes a connection between a team and an IdP group. When adding groups to a team, you must include all new and existing groups to avoid replacing existing groups with the new ones. Specifying an empty groups array will remove all connections for a team.

Team synchronization is available for organizations using GitHub Enterprise Cloud. For more information, see GitHub's products in the GitHub Help documentation.

[!NOTE] You can also specify a team by org_id and team_id using the route PATCH /organizations/{org_id}/team/{team_id}/team-sync/group-mappings.

patch/orgs/{org}/teams/{team_slug}/team-sync/group-mappings

Path parameters

orgstring required

The organization name. The name is not case sensitive.

team_slugstring required

The slug of the team name.

Request body

Response

Response

Example response

{
  "groups": [
    {
      "group_id": "111a1a11-aaa1-1aaa-11a1-a1a1a1a1a1aa",
      "group_name": "saml-azuread-test",
      "group_description": "A group of Developers working on AzureAD SAML SSO"
    },
    {
      "group_id": "2bb2bb2b-bb22-22bb-2bb2-bb2bbb2bb2b2",
      "group_name": "saml-azuread-test2",
      "group_description": "Another group of Developers working on AzureAD SAML SSO"
    }
  ]
}