Preview the new Nested Teams APIs

We're releasing new endpoints and changes to existing endpoints to better help you administer your organization's nested teams.

New endpoints

Changes to existing API endpoints

  • The List team members and Get team membership endpoints will now include both direct and child team members.

  • The List team repositories and Check if a team manages a repository endpoints now include both direct and inherited repositories.

  • You can now create a team with a parent team by passing the parent_team_id parameter to the Create team endpoint.

  • You can now update a team's parent team by passing the parent_team_id parameter to the Edit team endpoint.

  • Deleting a nested team through the Delete team endpoint will delete the team and all its child teams. Note: this action is only available to organization admins.

  • Listing a repository's collaborators through the Lists collaborators will now include child team members.

  • Endpoints that return team hashes will now include the parent field representing the parent team. Additionally, the members_count and repositories_count will include all members and repositories according to the nested structure.

To access the Nested Teams APIs during the preview period, you must provide a custom media type in the Accept header:


During the preview period, we may change aspects of these API methods based on developer feedback. If we do, we will announce the changes here on the developer blog, but we will not provide any advance notice.

If you have any questions or feedback, please let us know!