BT

GitHub New Organization Membership APIs Now in Preview

| by Sergio De Simone Follow 21 Followers on Nov 30, 2016. Estimated reading time: 1 minute |

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:

application/vnd.github.korra-preview+json

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

Rate this Article

Adoption Stage
Style

Hello stranger!

You need to Register an InfoQ account or or login to post comments. But there's so much more behind being registered.

Get the most out of the InfoQ experience.

Tell us what you think

Allowed html: a,b,br,blockquote,i,li,pre,u,ul,p

Email me replies to any of my messages in this thread
Community comments

Allowed html: a,b,br,blockquote,i,li,pre,u,ul,p

Email me replies to any of my messages in this thread

Allowed html: a,b,br,blockquote,i,li,pre,u,ul,p

Email me replies to any of my messages in this thread

Discuss
BT