Facilitating the Spread of Knowledge and Innovation in Professional Software Development

Write for InfoQ


Choose your language

InfoQ Homepage News GitHub New Organization Membership APIs Now in Preview

GitHub New Organization Membership APIs Now in Preview

GitHub has introduced new API endpoints to better manage organizations on its platform. A new Outside Collaborators API will enable remote administration of access privileges and user-management.

An outside collaborator in GitHub is someone who is not a member of an organization but has read, write, or admin privileges for a number of repositories in that organization. Outside collaborators are often consultants or temporary employees who lose their status of full members while retaining some privileges for concrete repositories.

The new outside collaborators API makes it possible to:

The outside collaborators API is part of the Organizations API which already included four main endpoints – organizations, members, teams, and webhooks. Both the members and organizations endpoints have been extended to better integrate with the new outside collaborator API. In particular:

Also, the collaborators API, part of the repositories API now allows to review a user’s permission level.

Additionally, a few existing endpoints have been adapted to better integrate with the new organization endpoints, adding the following new features:

  • when getting or editing an organization, two new organization-wide settings can be retrieved and set: the default_repository_permission and members_can_create_repositories
  • the create team endpoint now supports a maintainers parameter that allow to add team maintainers
  • the list collaborators endpoint now supports an affiliation parameter to filter a repository’s collaborators by their affiliation type

All new or modified endpoints require a custom media type in the Accept header:


Being only a preview, the new APIs can be changed by GitHub without previous notice based on developer feedback.

Rate this Article