v56

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

teams

Create or update IdP group connections (Legacy)

[!WARNING] Endpoint closing down notice: This endpoint route is closing down and will be removed from the Teams API. We recommend migrating your existing code to use the new Create or update IdP group connections endpoint.

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

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.

patch/teams/{team_id}/team-sync/group-mappings

Path parameters

team_idinteger required

The unique identifier of the team.

Request body

synced_atstring

Example request

{
  "groups": [
    {
      "id": "\"caceab43fc9ffa20081c\"",
      "name": "\"external-team-6c13e7288ef7\"",
      "description": "\"moar cheese pleese\""
    }
  ],
  "synced_at": "\"I am not a timestamp\""
}

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"
    }
  ]
}