{"id":94409,"date":"2026-03-12T09:00:07","date_gmt":"2026-03-12T16:00:07","guid":{"rendered":"https:\/\/github.blog\/changelog\/2026-03-10-rest-api-version-2026-03-10-is-now-available"},"modified":"2026-03-12T09:15:30","modified_gmt":"2026-03-12T16:15:30","slug":"rest-api-version-2026-03-10-is-now-available","status":"publish","type":[3521],"link":"https:\/\/github.blog\/changelog\/2026-03-12-rest-api-version-2026-03-10-is-now-available","title":{"rendered":"REST API version 2026-03-10 is now available"},"content":{"rendered":"\n

Previously, we introduced calendar-based versioning<\/a> for our REST API, giving us a path to evolving our API while giving integrators plenty of time and clear guidance for upgrading.<\/p>\n

Now, we’re releasing calendar version 2026-03-10<\/code><\/strong>, the newest version of the GitHub REST API. This is the first calendar version to include breaking changes<\/strong>.<\/p>\n

What’s in this release<\/span><\/a><\/h2>\n

Version 2026-03-10<\/code> introduces a set of breaking changes to the REST API. You can find the full list of changes, along with upgrade guidance<\/a>, in our breaking changes documentation<\/a>. <\/p>\n

As a reminder, non-breaking changes (e.g., new endpoints, optional parameters, additional response fields) continue to be available across all supported API versions.<\/p>\n

What this means for existing integrations<\/span><\/a><\/h2>\n

Version 2022-11-28<\/code> will continue to be fully supported for at least 24 months from today, and requests that don’t include the X-GitHub-Api-Version<\/code> header will continue to default to 2022-11-28<\/code>.<\/p>\n

When you’re ready to upgrade, it’s straightforward. After reviewing the new version documentation and making any necessary changes to your integration to account for breaking changes, update the X-GitHub-Api-Version<\/code> header to 2026-03-10<\/code> and verify that your integration works as expected with the new API version.<\/p>\n

Use the version picker in our API documentation<\/a> to view the docs for all available versions.<\/p>\n

What’s next<\/span><\/a><\/h2>\n

We’ll continue to communicate future API version releases through the GitHub changelog. <\/p>\n

We’d love for integrators to adopt 2026-03-10<\/code> to take advantage of the latest enhancements and features. While there’s no pressure to upgrade immediately, moving to the new version will help ensure your integration remains compatible and benefits from ongoing improvements as we continue to release new versions over time.<\/p>\n<\/body><\/html>\n","protected":false},"excerpt":{"rendered":"

Previously, we introduced calendar-based versioning for our REST API, giving us a path to evolving our API while giving integrators plenty of time and clear guidance for upgrading. Now, we’re…<\/p>\n","protected":false},"author":2106,"featured_media":0,"template":"","meta":{"_gh_post_show_toc":"","_gh_post_is_no_robots":"","_gh_post_is_featured":"","_gh_post_is_excluded":"","_gh_post_is_unlisted":"","_gh_post_related_link_1":"","_gh_post_related_link_2":"","_gh_post_related_link_3":"","_gh_post_sq_img":"","_gh_post_sq_img_id":"","_gh_post_cta_title":"","_gh_post_cta_text":"","_gh_post_cta_link":"","_gh_post_cta_button":"","_gh_post_recirc_hide":"","_gh_post_recirc_col_1":"","_gh_post_recirc_col_2":"","_gh_post_recirc_col_3":"","_gh_post_recirc_col_4":"","_featured_video":"","_gh_post_additional_query_params":"","footnotes":"","primary_cta":"","primary_cta_url":"","secondary_cta":"","secondary_cta_url":""},"label":[1751],"group":[3810],"coauthors":[3100],"class_list":["post-94409","changelog","type-changelog","status-publish","hentry","changelog-type-new-releases","changelog-label-ecosystem-and-accessibility","changelog-group-03-2026"],"yoast_head":"\nREST API version 2026-03-10 is now available - GitHub Changelog<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/github.blog\/changelog\/2026-03-12-rest-api-version-2026-03-10-is-now-available\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"REST API version 2026-03-10 is now available \u00b7 GitHub Changelog\" \/>\n<meta property=\"og:description\" content=\"Previously, we introduced calendar-based versioning for our REST API, giving us a path to evolving our API while giving integrators plenty of time and clear guidance for upgrading. Now, we’re…\" \/>\n<meta property=\"og:url\" content=\"https:\/\/github.blog\/changelog\/2026-03-12-rest-api-version-2026-03-10-is-now-available\/\" \/>\n<meta property=\"og:site_name\" content=\"The GitHub Blog\" \/>\n<meta property=\"article:modified_time\" content=\"2026-03-12T16:15:30+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/github.blog\/wp-content\/uploads\/2026\/03\/556129565-d35e0760-1b6c-436b-b055-01b8f102245c.jpg\" \/>\n\t<meta property=\"og:image:width\" content=\"1200\" \/>\n\t<meta property=\"og:image:height\" content=\"630\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/png\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"2 minutes\" \/>\n\t<meta name=\"twitter:label2\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data2\" content=\"Allison\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/github.blog\/changelog\/2026-03-12-rest-api-version-2026-03-10-is-now-available\/\",\"url\":\"https:\/\/github.blog\/changelog\/2026-03-12-rest-api-version-2026-03-10-is-now-available\/\",\"name\":\"REST API version 2026-03-10 is now available - The GitHub Blog\",\"isPartOf\":{\"@id\":\"https:\/\/github.blog\/#website\"},\"datePublished\":\"2026-03-12T16:00:07+00:00\",\"dateModified\":\"2026-03-12T16:15:30+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/github.blog\/changelog\/2026-03-12-rest-api-version-2026-03-10-is-now-available\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/github.blog\/changelog\/2026-03-12-rest-api-version-2026-03-10-is-now-available\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/github.blog\/changelog\/2026-03-12-rest-api-version-2026-03-10-is-now-available\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/github.blog\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Changelogs\",\"item\":\"https:\/\/github.blog\/changelog\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"REST API version 2026-03-10 is now available\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/github.blog\/#website\",\"url\":\"https:\/\/github.blog\/\",\"name\":\"The GitHub Blog\",\"description\":\"Updates, ideas, and inspiration from GitHub to help developers build and design software.\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/github.blog\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO Premium plugin. -->","yoast_head_json":{"title":"REST API version 2026-03-10 is now available - GitHub Changelog","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/github.blog\/changelog\/2026-03-12-rest-api-version-2026-03-10-is-now-available\/","og_locale":"en_US","og_type":"article","og_title":"REST API version 2026-03-10 is now available \u00b7 GitHub Changelog","og_description":"Previously, we introduced calendar-based versioning for our REST API, giving us a path to evolving our API while giving integrators plenty of time and clear guidance for upgrading. Now, we’re…","og_url":"https:\/\/github.blog\/changelog\/2026-03-12-rest-api-version-2026-03-10-is-now-available\/","og_site_name":"The GitHub Blog","article_modified_time":"2026-03-12T16:15:30+00:00","og_image":[{"width":1200,"height":630,"url":"https:\/\/github.blog\/wp-content\/uploads\/2026\/03\/556129565-d35e0760-1b6c-436b-b055-01b8f102245c.jpg","type":"image\/png"}],"twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"2 minutes","Written by":"Allison"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/github.blog\/changelog\/2026-03-12-rest-api-version-2026-03-10-is-now-available\/","url":"https:\/\/github.blog\/changelog\/2026-03-12-rest-api-version-2026-03-10-is-now-available\/","name":"REST API version 2026-03-10 is now available - The GitHub Blog","isPartOf":{"@id":"https:\/\/github.blog\/#website"},"datePublished":"2026-03-12T16:00:07+00:00","dateModified":"2026-03-12T16:15:30+00:00","breadcrumb":{"@id":"https:\/\/github.blog\/changelog\/2026-03-12-rest-api-version-2026-03-10-is-now-available\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/github.blog\/changelog\/2026-03-12-rest-api-version-2026-03-10-is-now-available\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/github.blog\/changelog\/2026-03-12-rest-api-version-2026-03-10-is-now-available\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/github.blog\/"},{"@type":"ListItem","position":2,"name":"Changelogs","item":"https:\/\/github.blog\/changelog\/"},{"@type":"ListItem","position":3,"name":"REST API version 2026-03-10 is now available"}]},{"@type":"WebSite","@id":"https:\/\/github.blog\/#website","url":"https:\/\/github.blog\/","name":"The GitHub Blog","description":"Updates, ideas, and inspiration from GitHub to help developers build and design software.","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/github.blog\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/github.blog\/wp-json\/wp\/v2\/changelogs\/94409","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/github.blog\/wp-json\/wp\/v2\/changelogs"}],"about":[{"href":"https:\/\/github.blog\/wp-json\/wp\/v2\/types\/changelog"}],"author":[{"embeddable":true,"href":"https:\/\/github.blog\/wp-json\/wp\/v2\/users\/2106"}],"version-history":[{"count":3,"href":"https:\/\/github.blog\/wp-json\/wp\/v2\/changelogs\/94409\/revisions"}],"predecessor-version":[{"id":94493,"href":"https:\/\/github.blog\/wp-json\/wp\/v2\/changelogs\/94409\/revisions\/94493"}],"wp:attachment":[{"href":"https:\/\/github.blog\/wp-json\/wp\/v2\/media?parent=94409"}],"wp:term":[{"taxonomy":"changelog-type","embeddable":true,"href":"https:\/\/github.blog\/wp-json\/wp\/v2\/type?post=94409"},{"taxonomy":"changelog-label","embeddable":true,"href":"https:\/\/github.blog\/wp-json\/wp\/v2\/label?post=94409"},{"taxonomy":"changelog-group","embeddable":true,"href":"https:\/\/github.blog\/wp-json\/wp\/v2\/group?post=94409"},{"taxonomy":"author","embeddable":true,"href":"https:\/\/github.blog\/wp-json\/wp\/v2\/coauthors?post=94409"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}