Article complete

GitHub Enables Smooth API Integration with Versioning Model

GitHub releases calendar-based versioning model to enable smooth migration for Rest API integrations

A dark background with code snippets and a prominent GitHub logo in the center, symbolizing API integration and versioning.

Key takeaways

  • GitHub has launched a calendar-based versioning model for its Rest API, facilitating smoother migrations for integrators.
  • This is the first significant change to the API in over a decade, addressing previous challenges with breaking changes.
  • New API versions will be released alongside breaking changes, while previous versions will remain accessible for two years.
  • Developers can select API versions on a request-by-request basis using the X-GitHub-Api-Version header.
  • Non-breaking changes will be available across all versions, ensuring continuous access to updates.

Takeaways drafted with AI from the article text.

GitHub has introduced a calendar-based versioning to Rest API, providing smooth migration for integrators to new versions of the API. 

The last time GitHub made any changes to its API was over a decade ago when it launched version 3 (“V3”). Since then, the company hasn’t been able to bring occasional breaking changes and ensure that all integrations have smooth migration paths or time to upgrade their integrations to new versions of the API, mainly because it didn’t have the right tools and processes to enable it. 

Updates are necessary to APIs as they bring new features, fix bugs, and enhance the developer experience. 

How it works

The company will release new versions every time it has to make breaking changes to the Rest API. By referring to this document, developers can see what counts as breaking and non-breaking.

Every new version will be named after the date it was released. After the release, the previous versions of the Rest API will still be available for up to two years. Users can choose the version they want after a new release on a request-by-request basis using the X-GitHub-Api-Version header. 

However, the versioning model only applies to breaking changes; non-breaking changes are available across all APIs. 

How to apply 

The Rest API currently in use is deemed version 2022-11-28. GitHub recommends that its integrators update their integration to send the new X-GitHub-Api-Version: 2022-11-28 header. However, this doesn’t mean developers must change the integration itself. 

This will allow users to upgrade to future versions of the API by pointing the X-GitHub-Api-Version header to the new version and ensuring that the integration is compatible with the version’s modifications.

For more information, read here. 

Published

Spotted an error? Tell our editors. Read our editorial standards and corrections.

More in this story

GitHub · 5 stories
  1. Amazon Unveils New AI Language Model that Beats GPT-3
  2. You are here: GitHub Enables Smooth API Integration with Versioning Model
  3. GitHub Copilot Rival, Augment Secures $252 Mn at $1 Bn Valuation to Boost AI for Developers
  4. You Can Now Build AI Agents in Kannada, Says GitHub Chief Thomas Dohmke
  5. DeepSeek Proposes Super-Agent Architecture to Automate AI Coding Workflows
About the author

Contributor

Ayush is interested in knowing how technology shapes and defines our culture, and our understanding of the world. He believes in exploring reality at the intersections of technology and art, science, and politics.

All stories
Belamy · Daily

The day’s AI news, before your first meeting.