Along with X API v2, we launched a new versioning strategy that enables developers to better understand when to expect changes to X’s public APIs, and when they will need to migrate to new versions.
Developers will be notified of deprecations, retirements, changes, and additions to the X API via our communication channels so they can appropriately plan to accommodate these changes in their development roadmap. All changes to the API will be noted in the changelog.
The X API currently has three different versions. We strongly encourage users to utilize X API v2 when planning their integration unless we have not released functionality to v2 that is required by your use case.
To learn more about each version, please visit the following pages:
Versioning for the X API will be represented by version numbers declared in the route path for our endpoints:
https://api.x.com/2/tweets
We aim to release major versions of the X API as necessary but no more frequently than every 12 months. A major version will be released when breaking changes are introduced in the API. We will publish migration guides when launching a new major version to help developers migrate over to the new version.
A breaking change requires developers to change their code to maintain existing functionality in their app. Non-breaking changes will be additive and rolled out to the most recent version when ready, requiring no work on a developer’s end unless you would like to take advantage of the new functionality.
If a breaking change must be rolled out mid-cycle (for security or privacy reasons), this change will be made to the most recent version.
These changes require developers to change their code to maintain existing functionality of their application.
First of all, here is our definition of what deprecation and retirement mean to the X API:
In most cases, as soon as a new version is released, the previous version will be marked as deprecated. Versions will remain in a deprecated state for a period of time, after which they will be retired.
Please stay informed to learn more about future deprecations and retirements.