{"meta":{"title":"API Versions","intro":"Learn how to specify which REST API version to use whenever you make a request to the REST API.","product":"REST API","breadcrumbs":[{"href":"/en/enterprise-cloud@latest/rest","title":"REST API"},{"href":"/en/enterprise-cloud@latest/rest/about-the-rest-api","title":"About the REST API"},{"href":"/en/enterprise-cloud@latest/rest/about-the-rest-api/api-versions","title":"API Versions"}],"documentType":"article"},"body":"# API Versions\n\nLearn how to specify which REST API version to use whenever you make a request to the REST API.\n\n## About API versioning\n\nThe GitHub REST API is versioned. The API version name is based on the date when the API version was released. For example, the API version `2026-03-10` was released on Tue, 10 Mar 2026.\n\nBreaking changes are changes that can potentially break an integration. Breaking changes will be released in a new API version. We will provide advance notice before releasing breaking changes. Breaking changes include:\n\n* Removing an entire operation\n* Removing or renaming a parameter\n* Removing or renaming a response field\n* Adding a new required parameter\n* Making a previously optional parameter required\n* Changing the type of a parameter or response field\n* Removing enum values\n* Adding a new validation rule to an existing parameter\n* Changing authentication or authorization requirements\n\nAny additive (non-breaking) changes will be available in all supported API versions. Additive changes are changes that should not break an integration. Additive changes include:\n\n* Adding an operation\n* Adding an optional parameter\n* Adding an optional request header\n* Adding a response field\n* Adding a response header\n* Adding enum values\n\nWhen a new REST API version is released, the previous API version will be supported for at least 24 more months following the release of the new API version.\n\n## Specifying an API version\n\nYou should use the `X-GitHub-Api-Version` header to specify an API version. For example:\n\n```shell\ncurl --header \"X-GitHub-Api-Version:2026-03-10\" https://api.github.com/zen\n```\n\nRequests without the `X-GitHub-Api-Version` header will default to use the `2022-11-28` version.\n\nIf you specify an API version that is no longer supported, you will receive a `410 Gone` response.\n\n## Upgrading to a new API version\n\nBefore upgrading to a new REST API version, you should read the changelog of breaking changes for the new API version to understand what breaking changes are included and to learn more about how to upgrade to that specific API version. For more information, see [Breaking changes](/en/enterprise-cloud@latest/rest/about-the-rest-api/breaking-changes).\n\nWhen you update your integration to specify the new API version in the `X-GitHub-Api-Version` header, you'll also need to make any changes required for your integration to work with the new API version.\n\nOnce your integration is updated, test your integration to verify that it works with the new API version.\n\n## API version closing down\n\nAPI versions are supported for 24 months after a newer API version is released.\n\nWhile a version is within its support window but approaching  closing down, GitHub includes the following headers in API responses to help you prepare for migration:\n\n* `Deprecation` — The date when the API version will be closing down, formatted as an HTTP date per [RFC 7231](https://tools.ietf.org/html/rfc7231#section-7.1.1.1). For example: `Wed, 27 Nov 2019 14:34:29 GMT`. <!-- markdownlint-disable-line GHD046 -->\n* `Sunset` — The date when the API version will be completely removed (retired), after which requests will return a `410 Gone` response. Follows [RFC 8594](https://tools.ietf.org/html/rfc8594). For example: `Fri, 27 Nov 2020 14:34:29 GMT`. <!-- markdownlint-disable-line GHD046 -->\n\nAfter the support window ends:\n\n* Requests that specify a closing down API version receive a `410 Gone` response.\n* Requests that do not specify an API version default to the next oldest supported version, not the closing down version. If you rely on unversioned requests, you may observe behavioral changes as older versions are removed from support.\n\nFor more information on migrating to a newer API version, see [Breaking changes](/en/enterprise-cloud@latest/rest/about-the-rest-api/breaking-changes).\n\n## Exceptions to standard versioning\n\nIn rare cases, GitHub may make changes outside the normal API versioning cadence. These are exceptional interventions that do not alter the standard versioning guarantees for most integrators.\n\n### Security, availability, and reliability issues\n\nCritical security vulnerabilities, data exposure risks, or severe reliability issues may require changes outside the normal release schedule. GitHub may release an unscheduled API version, backport fixes to supported versions, or in rare cases, introduce a breaking change to an existing version to protect users and platform integrity.\n\nGitHub will communicate such changes through release notes, changelogs, and direct communication explaining what changed and why. Where feasible, advance notice will be provided. Immediate action may be taken without advance notice when required.\n\n### Low-usage services\n\nFor certain services with very low usage, GitHub may deprecate functionality outside the standard versioning process. In these cases, GitHub will communicate the intent and reach out to affected integrators directly.\n\n## Supported API versions\n\nThe following REST API versions are currently supported.\n\n| API version  | End of support date |\n| ------------ | ------------------- |\n| `2026-03-10` | Not yet scheduled   |\n| `2022-11-28` | March 10, 2028      |\n\nYou can also make an API request to get all of the supported API versions. For more information, see [REST API endpoints for meta data](/en/enterprise-cloud@latest/rest/meta/meta#get-all-api-versions)."}