{"id":98810,"date":"2026-10-01T09:00:00","date_gmt":"2026-10-01T16:00:00","guid":{"rendered":"https:\/\/opensource.microsoft.com\/blog\/?p=98810"},"modified":"2026-10-01T13:02:41","modified_gmt":"2026-10-01T20:02:41","slug":"from-standards-to-software-microsofts-ongoing-work-on-openapi-and-developer-tooling","status":"publish","type":"post","link":"https:\/\/opensource.microsoft.com\/blog\/2026\/10\/01\/from-standards-to-software-microsofts-ongoing-work-on-openapi-and-developer-tooling\/","title":{"rendered":"From standards to software: Microsoft\u2019s ongoing work on OpenAPI and developer tooling"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">Today I\u2019m excited to share several updates across Microsoft products, open-source projects, and services related to OpenAPI and JSON Schema support.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Taken together, these updates show how specifications are moving from background plumbing to active developer experience infrastructure: they help teams describe APIs more accurately, build better tools, and make AI-assisted development more reliable.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"why-openapi-and-json-schema-matter-for-ai-assisted-development\">Why OpenAPI and JSON Schema matter for AI-assisted development<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Open specifications enable interoperable ecosystems of products, tools, and services, while giving engineering teams the precision they need to build consistently across implementations. Microsoft has long contributed to specifications such as OpenAPI and remains committed to advancing them as the foundation for better engineering practices.<\/p>\n\n\n\n<div class=\"wp-block-buttons is-content-justification-center is-layout-flex wp-container-core-buttons-is-layout-a89b3969 wp-block-buttons-is-layout-flex\">\n<div class=\"wp-block-button\"><a class=\"wp-block-button__link wp-element-button\" href=\"https:\/\/learn.microsoft.com\/en-us\/openapi\/\" target=\"_blank\" rel=\"noopener noreferrer\">Explore OpenAPI at Microsoft<\/a><\/div>\n<\/div>\n\n\n\n<p class=\"wp-block-paragraph\">In the age of AI-assisted and agentic development, that precision matters even more. Because large language models are probabilistic, grounding their work in detailed specifications improves the reliability of generated code.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"what-is-openapi-and-why-developers-use-it\">What is OpenAPI and why developers use it?<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">OpenAPI is a language-agnostic specification for describing REST APIs in a way that both humans and tools can understand. For more than a decade, it has been the de facto standard for REST API descriptions, backed by a broad community of vendors, tool builders, and practitioners.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"openapi-3-2-0-what-s-new-for-api-developers\">OpenAPI 3.2.0: What\u2019s new for API developers<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\"><a href=\"https:\/\/spec.openapis.org\/oas\/v3.2.0.html\" target=\"_blank\" rel=\"noopener noreferrer\">OpenAPI 3.2.0<\/a> brings updates to tags, improves performance through the added <a href=\"https:\/\/www.rfc-editor.org\/rfc\/rfc10008.html\" target=\"_blank\" rel=\"noopener noreferrer\">HTTP QUERY<\/a> support, improves security through <a href=\"https:\/\/www.rfc-editor.org\/info\/rfc8628\/\" target=\"_blank\" rel=\"noopener noreferrer\">added device flow support<\/a>, and adds support of <a href=\"https:\/\/spec.openapis.org\/oas\/v3.2.0.html#streaming-sequential-media-types\" target=\"_blank\" rel=\"noopener noreferrer\">streaming data<\/a>. These improvements give API producers more precise ways to describe modern, AI-ready API patterns.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">You can learn more in the <a href=\"https:\/\/www.openapis.org\/blog\/2025\/09\/23\/announcing-openapi-v3-2\" target=\"_blank\" rel=\"noopener noreferrer\">announcing OpenAPI v3.2<\/a> blog post.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"json-schema-2020-12-key-improvements-for-openapi-and-api-design\">JSON Schema 2020-12: Key improvements for OpenAPI and API design<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Improving OpenAPI support also led us to improve support for JSON Schema. The latest version of JSON Schema brings support for $dynamicRef\/Anchor which finally solves recursive schemas without brittle $ref chains. It also clarifies vocabulary handling and improves interoperability. Better schemas mean a greater ability for you to catch issues earlier on!<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"case-study-how-microsoft-foundry-uses-openapi-typespec-and-json-schema\">Case study: How Microsoft Foundry uses OpenAPI, TypeSpec, and JSON Schema<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Foundry provides a useful example of how specifications, converters, schemas, editors, gateways, and generated assets can reinforce one another across a large platform.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><a href=\"https:\/\/ai.azure.com\/\" target=\"_blank\" rel=\"noopener noreferrer\">Microsoft Foundry<\/a> is a platform for building AI and agentic solutions, with thousands of models from many providers, evaluation and fine-tuning capabilities, agent building and hosting, and more.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Foundry exposes its own REST APIs for platform-specific capabilities, while also maintaining full fidelity with OpenAI\u2019s REST APIs so customers can move solutions between them without rebuilding from scratch.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">This is where strong specifications and the tooling around them helped accelerate that work, control implementation costs, and improve overall quality.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">OpenAI maintains an <a href=\"https:\/\/github.com\/openai\/openai-openapi\/\" target=\"_blank\" rel=\"noopener noreferrer\">OpenAPI description<\/a> for everyone to use, which it also uses internally to generate software development kits (SDKs) and more. The Foundry developer experience team imports that description as a TypeSpec definition using the <a href=\"https:\/\/typespec.io\/docs\/emitters\/openapi3\/cli\/#converting-openapi-3-into-typespec\" target=\"_blank\" rel=\"noopener noreferrer\">TypeSpec convert tool.<\/a><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Using those definitions, Foundry service teams can describe their additional APIs in TypeSpec and use the consolidated model to:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li class=\"wp-block-list-item\">Generate SDKs.<\/li>\n\n\n\n<li class=\"wp-block-list-item\">Generate the <a href=\"https:\/\/ai.azure.com\/api-reference\" target=\"_blank\" rel=\"noopener noreferrer\">Foundry API reference.<\/a><\/li>\n\n\n\n<li class=\"wp-block-list-item\">Generate server-side code.<\/li>\n\n\n\n<li class=\"wp-block-list-item\">Perform contract testing to ensure highfidelity with the OpenAI REST API.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">The developer experience for engineers across the platform is also supported by JSON Schema and Schema Store integration in Visual Studio Code, while parts of the service infrastructure rely on API Management under the hood.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"microsoft-investments-in-openapi-json-schema-and-developer-tooling\">Microsoft investments in OpenAPI, JSON Schema, and developer tooling<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Over the last year, multiple teams at Microsoft have worked to bring products and services up to date with the latest developments in the OpenAPI and JSON Schema space. The examples below show how that work is landing across libraries, frameworks, editors, API platforms, and AI developer experiences.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"net\">.NET<\/h3>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"microsoft-openapi\">Microsoft.OpenAPI<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\"><a href=\"https:\/\/github.com\/microsoft\/OpenAPI.NET\" target=\"_blank\" rel=\"noopener noreferrer\">Microsoft.OpenAPI<\/a> is the main .NET library for parsing, building, and serializing OpenAPI descriptions. A shared implementation helps the ecosystem avoid duplicating the complex work required to fully support the specification.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">This library provides a foundation for <a href=\"https:\/\/www.nuget.org\/packages\/Microsoft.aspnetcore.openapi\" target=\"_blank\" rel=\"noopener noreferrer\">ASP.NET Core OpenAPI integration<\/a>, <a href=\"https:\/\/www.nuget.org\/packages\/Swashbuckle.AspNetCore.Swagger\/\" target=\"_blank\" rel=\"noopener noreferrer\">Swashbuckle<\/a>, <a href=\"https:\/\/azure.microsoft.com\/en-us\/products\/api-management\" id=\"https:\/\/azure.microsoft.com\/en-us\/products\/api-management\" target=\"_blank\" rel=\"noopener noreferrer\">Azure API Management<\/a>, <a href=\"https:\/\/aka.ms\/kiota\" target=\"_blank\" rel=\"noopener noreferrer\">Microsoft Kiota<\/a>, and hundreds of product teams at Microsoft.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">After OpenAPI 3.2.0 was released, we shipped a new <a href=\"https:\/\/github.com\/microsoft\/OpenAPI.NET\/releases\/tag\/v3.0.0\" target=\"_blank\" rel=\"noopener noreferrer\">Microsoft.OpenAPI version with support for the updated specification<\/a> so the broader ecosystem could adopt the new capabilities. That work, along with countless contributions since, was done by community members like you!<\/p>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"asp-net-core-in-net-11\">ASP.NET Core in .NET 11<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\"><a href=\"https:\/\/dotnet.microsoft.com\/en-us\/apps\/aspnet\" target=\"_blank\" rel=\"noopener noreferrer\">ASP.NET Core<\/a> is Microsoft\u2019s open-source, cross-platform framework for building modern web apps, services, and APIs with .NET. It gives developers a high-performance foundation for creating cloud-ready applications that can run on Windows, Linux, and macOS.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">ASP.NET Core in .NET 11 continues to make OpenAPI a first-class part of the web API developer experience. In this release, ASP.NET Core adds support for OpenAPI 3.2.0 by default, built on Microsoft.OpenAPI, giving developers a clear path to describe and validate modern API patterns.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The list of new capabilities was <a href=\"https:\/\/github.com\/dotnet\/aspnetcore\/issues\/63754\" target=\"_blank\" rel=\"noopener noreferrer\">informed by the community<\/a> and includes support for:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li class=\"wp-block-list-item\">HTTP QUERY operations.<\/li>\n\n\n\n<li class=\"wp-block-list-item\">Server-Sent Events (SSE) streams.<\/li>\n\n\n\n<li class=\"wp-block-list-item\">Accurate binary and file result response schemas.<\/li>\n\n\n\n<li class=\"wp-block-list-item\">C# union-typed responses.<\/li>\n\n\n\n<li class=\"wp-block-list-item\">And many more improvements!<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">Note: .NET 11 will become generally available in November 2026 and is currently in public preview.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"typespec\">TypeSpec<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\"><a href=\"https:\/\/typespec.io\/\" target=\"_blank\" rel=\"noopener noreferrer\">TypeSpec<\/a> is Microsoft\u2019s open-source language for designing APIs in a concise, reusable, specification-friendly way. Teams can define their model once in TypeSpec and generate OpenAPI descriptions, JSON Schemas, documentation, and client or server code from that source of truth.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Over the last year, we\u2019ve greatly improved the <a href=\"https:\/\/github.com\/microsoft\/typespec\/pulls?q=is%3Apr+is%3Amerged+label%3Aopenapi3%3Aconverter+merged%3A2025-08-01..2026-07-01\" target=\"_blank\" rel=\"noopener noreferrer\">OpenAPI to TypeSpec convert tool<\/a>, enabling lift-and-shift production scenarios where API producers and architects can build on existing API investments while improving their design experience.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">We\u2019ve also added support for emitting <a href=\"https:\/\/github.com\/microsoft\/typespec\/pulls?q=is%3Apr+is%3Amerged+label%3Aemitter%3Aopenapi3+merged%3A2025-08-01..2026-07-01\" target=\"_blank\" rel=\"noopener noreferrer\">OpenAPI 3.2.0 descriptions and implemented new OpenAPI capabilities<\/a>, so once you\u2019re done designing your API, you can get high-fidelity OpenAPI descriptions and use them in your favorite tool\/platform.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"visual-studio-code\">Visual Studio Code<\/h3>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"support-for-json-schema-2020-12\">Support for JSON schema 2020-12<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">Developers spend a lot of their time in the integrated development environment (IDE). When reviewing or authoring any JSON document, they expect that environment to catch simple mistakes and provide accurate autocompletion.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Visual Studio Code uses a JSON language server to provide syntax highlighting and validate documents against JSON Schema. Until recently, that language server only supported JSON Schema Draft 07, <a href=\"https:\/\/json-schema.org\/draft-07\" target=\"_blank\" rel=\"noopener noreferrer\">a specification published back in 2018<\/a>.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">This meant that if your JSON document relied on a schema that used more modern capabilities from JSON Schema 2019-09 or 2020-12, some validation rules could be ignored or fail entirely. OpenAPI 3.1 and 3.2 are good examples because their schemas rely on JSON Schema 2020-12 to validate that a document is properly structured.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Since version 1.130.0, Visual Studio Code now supports JSON Schema 2019-09 and 2020-12, offering the latest validation experience you could ask for any JSON document.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"built-in-openapi-and-schema-validation-in-visual-studio-code\">Built-in OpenAPI and schema validation in Visual Studio Code<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">In version 1.140.0, Visual Studio Code also added built-in schema mappings for OpenAPI, Overlay, and Arazzo documents.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Combined with support for newer JSON Schema versions, these built-in mappings give known JSON documents, including OpenAPI 3.2 documents, structural validation in Visual Studio Code without requiring a third-party extension.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"help-improve-json-schema-store-integration-in-visual-studio-code\">Help improve JSON Schema Store integration in Visual Studio Code<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">The JSON Schema Store is an open-source catalog of schemas for common JSON documents. Each catalog entry can also include metadata such as the filename patterns associated with that schema.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Integrating the JSON Schema Store would let Visual Studio Code automatically select and validate against the appropriate schema based on known filename patterns, without requiring manual configuration or a $schema property. If you\u2019d like to see this capability, please <a href=\"https:\/\/github.com\/microsoft\/vscode\/issues\/26289\" target=\"_blank\" rel=\"noopener noreferrer\">upvote this issue<\/a>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"azure-api-management\">Azure API Management<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\"><a href=\"https:\/\/azure.microsoft.com\/products\/api-management\" target=\"_blank\" rel=\"noopener noreferrer\">Azure API Management<\/a> helps teams publish, secure, govern, monitor, and expose backend APIs, including REST and AI APIs, through managed gateways and developer portal experiences powered by OpenAPI descriptions.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Until recently, API Management only supported up to OpenAPI 3.1 for <a href=\"https:\/\/learn.microsoft.com\/en-us\/azure\/api-management\/import-api-from-oas?tabs=portal\" target=\"_blank\" rel=\"noopener noreferrer\">ingestion<\/a> and 3.0 for publishing. With the support for OpenAPI 3.2, customers can expand how they define and publish APIs and integrate with other platforms. This update also improves support for importing OpenAI v1 model APIs, making it easier to automate API creation and manage traffic to OpenAI models through AI Gateway capabilities in API Management that thousands of Azure customers rely on.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">API Management is deploying OpenAPI 3.2.0 support across Azure regions and service tiers.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"recognizing-the-contributors-advancing-the-openapi-ecosystem\">Recognizing the contributors advancing the OpenAPI ecosystem<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Thank you for using, maintaining, and contributing to the specifications, libraries, tools, and services that make this ecosystem work. OpenAPI succeeds because people across organizations keep improving both the standard and the developer experiences built on top of it.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Special thanks to:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li class=\"wp-block-list-item\"><a href=\"https:\/\/github.com\/keegan-caruso\" target=\"_blank\" rel=\"noopener noreferrer\">Keegan Caruso<\/a> and <a href=\"https:\/\/github.com\/aeschli\" target=\"_blank\" rel=\"noopener noreferrer\">Martin Aeschlimann<\/a> for the JSON Schema work in Visual Studio Code.<\/li>\n\n\n\n<li class=\"wp-block-list-item\"><a href=\"https:\/\/github.com\/madskristensen\" target=\"_blank\" rel=\"noopener noreferrer\">Mads Kristensen<\/a> for maintaining the JSON Schema Store project.<\/li>\n\n\n\n<li class=\"wp-block-list-item\"><a href=\"https:\/\/github.com\/timotheeguerin\" target=\"_blank\" rel=\"noopener noreferrer\">Timoth\u00e9e Guerin<\/a> for maintaining the TypeSpec project.<\/li>\n\n\n\n<li class=\"wp-block-list-item\"><a href=\"https:\/\/github.com\/youssef1313\" target=\"_blank\" rel=\"noopener noreferrer\">Youssef Fahmy<\/a> for all his work on ASP.NET Core.<\/li>\n\n\n\n<li class=\"wp-block-list-item\">The Azure API Management engineering team.<\/li>\n\n\n\n<li class=\"wp-block-list-item\">The <a href=\"https:\/\/www.openapis.org\/\" target=\"_blank\" rel=\"noopener noreferrer\">OpenAPI Initiative<\/a>, and maintainers.<\/li>\n\n\n\n<li class=\"wp-block-list-item\">The <a href=\"https:\/\/json-schema.org\" target=\"_blank\" rel=\"noopener noreferrer\">JSON Schema organization<\/a>.<\/li>\n\n\n\n<li class=\"wp-block-list-item\">The <a href=\"https:\/\/www.linuxfoundation.org\/\" id=\"https:\/\/www.linuxfoundation.org\/\" target=\"_blank\" rel=\"noopener noreferrer\">Linux Foundation<\/a>.<\/li>\n<\/ul>\n\n\n\n<div class=\"is-style-compact wp-block-bloginabox-theme-promotional\">\n\t\n<div class=\"promotional\">\n\t<div class=\"promotional__wrapper\">\n\t\t<div class=\"promotional__content-wrapper\">\n\t\t\t<div class=\"promotional__content\">\n\t\t\t\t\n\n<h2 class=\"wp-block-heading\" id=\"build-better-apis-with-openapi\">Build better APIs with OpenAPI<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Explore Microsoft\u2019s OpenAPI documentation, tools, and SDK resources to learn how to work with OpenAPI-described APIs and build modern API development experiences.<\/p>\n\n\n\n<div class=\"wp-block-buttons is-layout-flex wp-block-buttons-is-layout-flex\">\n<div class=\"wp-block-button\"><a aria-label=\"Explore OpenAPI: Build better APIs with OpenAPI\" data-bi-an=\"Global CTA\" data-bi-ct=\"cta link\" data-bi-id=\"cta-block\" class=\"wp-block-button__link wp-element-button\" href=\"https:\/\/learn.microsoft.com\/en-us\/openapi\/\" target=\"_blank\" rel=\"noopener noreferrer\">Explore OpenAPI<\/a><\/div>\n<\/div>\n\n\t\t\t<\/div>\n\t\t<\/div>\n\t\t\t<\/div>\n<\/div>\n<\/div>\n\n\n\n<p class=\"wp-block-paragraph\"><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Explore Microsoft\u2019s ongoing work across OpenAPI, JSON Schema, and developer tooling. See how improvements across Microsoft Foundry, .NET, TypeSpec, Visual Studio Code, and Azure API Management are helping developers describe APIs more accurately, build better tools, and support more reliable AI-assisted development.<\/p>\n","protected":false},"author":6289,"featured_media":98812,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_classifai_error":"","_classifai_text_to_speech_error":"","_alt_title":"","ms-ems-related-posts":[],"footnotes":""},"tags":[136,2272,166,224],"programming-languages":[2253,2256],"content-type":[361],"job-role":[],"topic":[2240,2248,2252],"coauthors":[2651],"class_list":["post-98810","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","tag-github","tag-microsoft","tag-azure","tag-visual-studio-code","programming-languages-net","programming-languages-asp-net","content-type-project-updates","topic-application-development","topic-standards","topic-tools","review-flag-1593580428-734","review-flag-1593580771-946","review-flag-1-1593580432-963","review-flag-2-1593580437-411","review-flag-3-1593580442-169","review-flag-integ-1593580288-449","review-flag-micro-1680215167-604","review-flag-new-1593580248-669","review-flag-publi-1593580761-124"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v27.4 - https:\/\/yoast.com\/product\/yoast-seo-wordpress\/ -->\n<title>From standards to software: Microsoft\u2019s ongoing work on OpenAPI and developer tooling | Microsoft Open Source Blog<\/title>\n<meta name=\"description\" content=\"Explore Microsoft\u2019s latest OpenAPI and JSON Schema improvements across .NET, TypeSpec, Visual Studio Code, Microsoft Foundry, and Azure API Management.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/opensource.microsoft.com\/blog\/2026\/10\/01\/from-standards-to-software-microsofts-ongoing-work-on-openapi-and-developer-tooling\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"From standards to software: Microsoft\u2019s ongoing work on OpenAPI and developer tooling | Microsoft Open Source Blog\" \/>\n<meta property=\"og:description\" content=\"Explore Microsoft\u2019s latest OpenAPI and JSON Schema improvements across .NET, TypeSpec, Visual Studio Code, Microsoft Foundry, and Azure API Management.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/opensource.microsoft.com\/blog\/2026\/10\/01\/from-standards-to-software-microsofts-ongoing-work-on-openapi-and-developer-tooling\/\" \/>\n<meta property=\"og:site_name\" content=\"Microsoft Open Source Blog\" \/>\n<meta property=\"article:published_time\" content=\"2026-10-01T16:00:00+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2026-10-01T20:02:41+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/opensource.microsoft.com\/blog\/wp-content\/uploads\/2026\/10\/Azure-Infrastructure-Dark-scaled.jpg\" \/>\n\t<meta property=\"og:image:width\" content=\"2560\" \/>\n\t<meta property=\"og:image:height\" content=\"1440\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/jpeg\" \/>\n<meta name=\"author\" content=\"Vincent Biret\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:image\" content=\"https:\/\/opensource.microsoft.com\/blog\/wp-content\/uploads\/2026\/10\/Azure-Infrastructure-Dark-scaled.jpg\" \/>\n<meta name=\"twitter:creator\" content=\"@OpenAtMicrosoft\" \/>\n<meta name=\"twitter:site\" content=\"@OpenAtMicrosoft\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Vincent Biret\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"7 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\\\/\\\/opensource.microsoft.com\\\/blog\\\/2026\\\/10\\\/01\\\/from-standards-to-software-microsofts-ongoing-work-on-openapi-and-developer-tooling\\\/#article\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/opensource.microsoft.com\\\/blog\\\/2026\\\/10\\\/01\\\/from-standards-to-software-microsofts-ongoing-work-on-openapi-and-developer-tooling\\\/\"},\"author\":[{\"@id\":\"https:\\\/\\\/opensource.microsoft.com\\\/blog\\\/author\\\/vincent-biret\\\/\",\"@type\":\"Person\",\"@name\":\"Vincent Biret\"}],\"headline\":\"From standards to software: Microsoft\u2019s ongoing work on OpenAPI and developer tooling\",\"url\":\"https:\\\/\\\/opensource.microsoft.com\\\/blog\\\/2026\\\/10\\\/01\\\/from-standards-to-software-microsofts-ongoing-work-on-openapi-and-developer-tooling\\\/\",\"description\":\"Explore Microsoft\u2019s latest OpenAPI and JSON Schema improvements across .NET, TypeSpec, Visual Studio Code, Microsoft Foundry, and Azure API Management.\",\"datePublished\":\"2026-10-01T16:00:00+00:00\",\"dateModified\":\"2026-10-01T20:02:41+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\\\/\\\/opensource.microsoft.com\\\/blog\\\/2026\\\/10\\\/01\\\/from-standards-to-software-microsofts-ongoing-work-on-openapi-and-developer-tooling\\\/\"},\"wordCount\":1501,\"publisher\":{\"@id\":\"https:\\\/\\\/opensource.microsoft.com\\\/blog\\\/#organization\"},\"image\":{\"@id\":\"https:\\\/\\\/opensource.microsoft.com\\\/blog\\\/2026\\\/10\\\/01\\\/from-standards-to-software-microsofts-ongoing-work-on-openapi-and-developer-tooling\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/opensource.microsoft.com\\\/blog\\\/wp-content\\\/uploads\\\/2026\\\/10\\\/Azure-Infrastructure-Dark-scaled.jpg\",\"keywords\":[\"GitHub\",\"Microsoft\",\"Microsoft Azure\",\"Visual Studio Code\"],\"inLanguage\":\"en-US\"},{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/opensource.microsoft.com\\\/blog\\\/2026\\\/10\\\/01\\\/from-standards-to-software-microsofts-ongoing-work-on-openapi-and-developer-tooling\\\/\",\"url\":\"https:\\\/\\\/opensource.microsoft.com\\\/blog\\\/2026\\\/10\\\/01\\\/from-standards-to-software-microsofts-ongoing-work-on-openapi-and-developer-tooling\\\/\",\"name\":\"From standards to software: Microsoft\u2019s ongoing work on OpenAPI and developer tooling | Microsoft Open Source Blog\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/opensource.microsoft.com\\\/blog\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/opensource.microsoft.com\\\/blog\\\/2026\\\/10\\\/01\\\/from-standards-to-software-microsofts-ongoing-work-on-openapi-and-developer-tooling\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/opensource.microsoft.com\\\/blog\\\/2026\\\/10\\\/01\\\/from-standards-to-software-microsofts-ongoing-work-on-openapi-and-developer-tooling\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/opensource.microsoft.com\\\/blog\\\/wp-content\\\/uploads\\\/2026\\\/10\\\/Azure-Infrastructure-Dark-scaled.jpg\",\"datePublished\":\"2026-10-01T16:00:00+00:00\",\"dateModified\":\"2026-10-01T20:02:41+00:00\",\"description\":\"Explore Microsoft\u2019s latest OpenAPI and JSON Schema improvements across .NET, TypeSpec, Visual Studio Code, Microsoft Foundry, and Azure API Management.\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/opensource.microsoft.com\\\/blog\\\/2026\\\/10\\\/01\\\/from-standards-to-software-microsofts-ongoing-work-on-openapi-and-developer-tooling\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/opensource.microsoft.com\\\/blog\\\/2026\\\/10\\\/01\\\/from-standards-to-software-microsofts-ongoing-work-on-openapi-and-developer-tooling\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/opensource.microsoft.com\\\/blog\\\/2026\\\/10\\\/01\\\/from-standards-to-software-microsofts-ongoing-work-on-openapi-and-developer-tooling\\\/#primaryimage\",\"url\":\"https:\\\/\\\/opensource.microsoft.com\\\/blog\\\/wp-content\\\/uploads\\\/2026\\\/10\\\/Azure-Infrastructure-Dark-scaled.jpg\",\"contentUrl\":\"https:\\\/\\\/opensource.microsoft.com\\\/blog\\\/wp-content\\\/uploads\\\/2026\\\/10\\\/Azure-Infrastructure-Dark-scaled.jpg\",\"width\":2560,\"height\":1440},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/opensource.microsoft.com\\\/blog\\\/2026\\\/10\\\/01\\\/from-standards-to-software-microsofts-ongoing-work-on-openapi-and-developer-tooling\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/opensource.microsoft.com\\\/blog\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"From standards to software: Microsoft\u2019s ongoing work on OpenAPI and developer tooling\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/opensource.microsoft.com\\\/blog\\\/#website\",\"url\":\"https:\\\/\\\/opensource.microsoft.com\\\/blog\\\/\",\"name\":\"Microsoft Open Source Blog\",\"description\":\"Open dialogue about openness at Microsoft \u2013 open source, standards, interoperability\",\"publisher\":{\"@id\":\"https:\\\/\\\/opensource.microsoft.com\\\/blog\\\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/opensource.microsoft.com\\\/blog\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\\\/\\\/opensource.microsoft.com\\\/blog\\\/#organization\",\"name\":\"Microsoft Open Source Blog\",\"url\":\"https:\\\/\\\/opensource.microsoft.com\\\/blog\\\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/opensource.microsoft.com\\\/blog\\\/#\\\/schema\\\/logo\\\/image\\\/\",\"url\":\"https:\\\/\\\/opensource.microsoft.com\\\/blog\\\/wp-content\\\/uploads\\\/2019\\\/08\\\/Microsoft-Logo.png\",\"contentUrl\":\"https:\\\/\\\/opensource.microsoft.com\\\/blog\\\/wp-content\\\/uploads\\\/2019\\\/08\\\/Microsoft-Logo.png\",\"width\":259,\"height\":194,\"caption\":\"Microsoft Open Source Blog\"},\"image\":{\"@id\":\"https:\\\/\\\/opensource.microsoft.com\\\/blog\\\/#\\\/schema\\\/logo\\\/image\\\/\"},\"sameAs\":[\"https:\\\/\\\/x.com\\\/OpenAtMicrosoft\"]},{\"@type\":\"Person\",\"@id\":\"https:\\\/\\\/opensource.microsoft.com\\\/blog\\\/#\\\/schema\\\/person\\\/a482e2fb7aa5666ed5484431270a6d3c\",\"name\":\"Hanan Irfan\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/522d67332be80985496670ce22fe40253c9bb06591d48578a0f56ce4ee66d2f1?s=96&d=microsoft&r=g8bc6cacf6db658e9287e84716a78bc03\",\"url\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/522d67332be80985496670ce22fe40253c9bb06591d48578a0f56ce4ee66d2f1?s=96&d=microsoft&r=g\",\"contentUrl\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/522d67332be80985496670ce22fe40253c9bb06591d48578a0f56ce4ee66d2f1?s=96&d=microsoft&r=g\",\"caption\":\"Hanan Irfan\"},\"url\":\"https:\\\/\\\/opensource.microsoft.com\\\/blog\\\/author\\\/hananirfan\\\/\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"From standards to software: Microsoft\u2019s ongoing work on OpenAPI and developer tooling | Microsoft Open Source Blog","description":"Explore Microsoft\u2019s latest OpenAPI and JSON Schema improvements across .NET, TypeSpec, Visual Studio Code, Microsoft Foundry, and Azure API Management.","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:\/\/opensource.microsoft.com\/blog\/2026\/10\/01\/from-standards-to-software-microsofts-ongoing-work-on-openapi-and-developer-tooling\/","og_locale":"en_US","og_type":"article","og_title":"From standards to software: Microsoft\u2019s ongoing work on OpenAPI and developer tooling | Microsoft Open Source Blog","og_description":"Explore Microsoft\u2019s latest OpenAPI and JSON Schema improvements across .NET, TypeSpec, Visual Studio Code, Microsoft Foundry, and Azure API Management.","og_url":"https:\/\/opensource.microsoft.com\/blog\/2026\/10\/01\/from-standards-to-software-microsofts-ongoing-work-on-openapi-and-developer-tooling\/","og_site_name":"Microsoft Open Source Blog","article_published_time":"2026-10-01T16:00:00+00:00","article_modified_time":"2026-10-01T20:02:41+00:00","og_image":[{"width":2560,"height":1440,"url":"https:\/\/opensource.microsoft.com\/blog\/wp-content\/uploads\/2026\/10\/Azure-Infrastructure-Dark-scaled.jpg","type":"image\/jpeg"}],"author":"Vincent Biret","twitter_card":"summary_large_image","twitter_image":"https:\/\/opensource.microsoft.com\/blog\/wp-content\/uploads\/2026\/10\/Azure-Infrastructure-Dark-scaled.jpg","twitter_creator":"@OpenAtMicrosoft","twitter_site":"@OpenAtMicrosoft","twitter_misc":{"Written by":"Vincent Biret","Est. reading time":"7 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/opensource.microsoft.com\/blog\/2026\/10\/01\/from-standards-to-software-microsofts-ongoing-work-on-openapi-and-developer-tooling\/#article","isPartOf":{"@id":"https:\/\/opensource.microsoft.com\/blog\/2026\/10\/01\/from-standards-to-software-microsofts-ongoing-work-on-openapi-and-developer-tooling\/"},"author":[{"@id":"https:\/\/opensource.microsoft.com\/blog\/author\/vincent-biret\/","@type":"Person","@name":"Vincent Biret"}],"headline":"From standards to software: Microsoft\u2019s ongoing work on OpenAPI and developer tooling","url":"https:\/\/opensource.microsoft.com\/blog\/2026\/10\/01\/from-standards-to-software-microsofts-ongoing-work-on-openapi-and-developer-tooling\/","description":"Explore Microsoft\u2019s latest OpenAPI and JSON Schema improvements across .NET, TypeSpec, Visual Studio Code, Microsoft Foundry, and Azure API Management.","datePublished":"2026-10-01T16:00:00+00:00","dateModified":"2026-10-01T20:02:41+00:00","mainEntityOfPage":{"@id":"https:\/\/opensource.microsoft.com\/blog\/2026\/10\/01\/from-standards-to-software-microsofts-ongoing-work-on-openapi-and-developer-tooling\/"},"wordCount":1501,"publisher":{"@id":"https:\/\/opensource.microsoft.com\/blog\/#organization"},"image":{"@id":"https:\/\/opensource.microsoft.com\/blog\/2026\/10\/01\/from-standards-to-software-microsofts-ongoing-work-on-openapi-and-developer-tooling\/#primaryimage"},"thumbnailUrl":"https:\/\/opensource.microsoft.com\/blog\/wp-content\/uploads\/2026\/10\/Azure-Infrastructure-Dark-scaled.jpg","keywords":["GitHub","Microsoft","Microsoft Azure","Visual Studio Code"],"inLanguage":"en-US"},{"@type":"WebPage","@id":"https:\/\/opensource.microsoft.com\/blog\/2026\/10\/01\/from-standards-to-software-microsofts-ongoing-work-on-openapi-and-developer-tooling\/","url":"https:\/\/opensource.microsoft.com\/blog\/2026\/10\/01\/from-standards-to-software-microsofts-ongoing-work-on-openapi-and-developer-tooling\/","name":"From standards to software: Microsoft\u2019s ongoing work on OpenAPI and developer tooling | Microsoft Open Source Blog","isPartOf":{"@id":"https:\/\/opensource.microsoft.com\/blog\/#website"},"primaryImageOfPage":{"@id":"https:\/\/opensource.microsoft.com\/blog\/2026\/10\/01\/from-standards-to-software-microsofts-ongoing-work-on-openapi-and-developer-tooling\/#primaryimage"},"image":{"@id":"https:\/\/opensource.microsoft.com\/blog\/2026\/10\/01\/from-standards-to-software-microsofts-ongoing-work-on-openapi-and-developer-tooling\/#primaryimage"},"thumbnailUrl":"https:\/\/opensource.microsoft.com\/blog\/wp-content\/uploads\/2026\/10\/Azure-Infrastructure-Dark-scaled.jpg","datePublished":"2026-10-01T16:00:00+00:00","dateModified":"2026-10-01T20:02:41+00:00","description":"Explore Microsoft\u2019s latest OpenAPI and JSON Schema improvements across .NET, TypeSpec, Visual Studio Code, Microsoft Foundry, and Azure API Management.","breadcrumb":{"@id":"https:\/\/opensource.microsoft.com\/blog\/2026\/10\/01\/from-standards-to-software-microsofts-ongoing-work-on-openapi-and-developer-tooling\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/opensource.microsoft.com\/blog\/2026\/10\/01\/from-standards-to-software-microsofts-ongoing-work-on-openapi-and-developer-tooling\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/opensource.microsoft.com\/blog\/2026\/10\/01\/from-standards-to-software-microsofts-ongoing-work-on-openapi-and-developer-tooling\/#primaryimage","url":"https:\/\/opensource.microsoft.com\/blog\/wp-content\/uploads\/2026\/10\/Azure-Infrastructure-Dark-scaled.jpg","contentUrl":"https:\/\/opensource.microsoft.com\/blog\/wp-content\/uploads\/2026\/10\/Azure-Infrastructure-Dark-scaled.jpg","width":2560,"height":1440},{"@type":"BreadcrumbList","@id":"https:\/\/opensource.microsoft.com\/blog\/2026\/10\/01\/from-standards-to-software-microsofts-ongoing-work-on-openapi-and-developer-tooling\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/opensource.microsoft.com\/blog\/"},{"@type":"ListItem","position":2,"name":"From standards to software: Microsoft\u2019s ongoing work on OpenAPI and developer tooling"}]},{"@type":"WebSite","@id":"https:\/\/opensource.microsoft.com\/blog\/#website","url":"https:\/\/opensource.microsoft.com\/blog\/","name":"Microsoft Open Source Blog","description":"Open dialogue about openness at Microsoft \u2013 open source, standards, interoperability","publisher":{"@id":"https:\/\/opensource.microsoft.com\/blog\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/opensource.microsoft.com\/blog\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/opensource.microsoft.com\/blog\/#organization","name":"Microsoft Open Source Blog","url":"https:\/\/opensource.microsoft.com\/blog\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/opensource.microsoft.com\/blog\/#\/schema\/logo\/image\/","url":"https:\/\/opensource.microsoft.com\/blog\/wp-content\/uploads\/2019\/08\/Microsoft-Logo.png","contentUrl":"https:\/\/opensource.microsoft.com\/blog\/wp-content\/uploads\/2019\/08\/Microsoft-Logo.png","width":259,"height":194,"caption":"Microsoft Open Source Blog"},"image":{"@id":"https:\/\/opensource.microsoft.com\/blog\/#\/schema\/logo\/image\/"},"sameAs":["https:\/\/x.com\/OpenAtMicrosoft"]},{"@type":"Person","@id":"https:\/\/opensource.microsoft.com\/blog\/#\/schema\/person\/a482e2fb7aa5666ed5484431270a6d3c","name":"Hanan Irfan","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/secure.gravatar.com\/avatar\/522d67332be80985496670ce22fe40253c9bb06591d48578a0f56ce4ee66d2f1?s=96&d=microsoft&r=g8bc6cacf6db658e9287e84716a78bc03","url":"https:\/\/secure.gravatar.com\/avatar\/522d67332be80985496670ce22fe40253c9bb06591d48578a0f56ce4ee66d2f1?s=96&d=microsoft&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/522d67332be80985496670ce22fe40253c9bb06591d48578a0f56ce4ee66d2f1?s=96&d=microsoft&r=g","caption":"Hanan Irfan"},"url":"https:\/\/opensource.microsoft.com\/blog\/author\/hananirfan\/"}]}},"bloginabox_animated_featured_image":null,"bloginabox_display_generated_audio":true,"distributor_meta":false,"distributor_terms":false,"distributor_media":false,"distributor_original_site_name":"Microsoft Open Source Blog","distributor_original_site_url":"https:\/\/opensource.microsoft.com\/blog","push-errors":false,"_links":{"self":[{"href":"https:\/\/opensource.microsoft.com\/blog\/wp-json\/wp\/v2\/posts\/98810","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/opensource.microsoft.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/opensource.microsoft.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/opensource.microsoft.com\/blog\/wp-json\/wp\/v2\/users\/6289"}],"replies":[{"embeddable":true,"href":"https:\/\/opensource.microsoft.com\/blog\/wp-json\/wp\/v2\/comments?post=98810"}],"version-history":[{"count":4,"href":"https:\/\/opensource.microsoft.com\/blog\/wp-json\/wp\/v2\/posts\/98810\/revisions"}],"predecessor-version":[{"id":98828,"href":"https:\/\/opensource.microsoft.com\/blog\/wp-json\/wp\/v2\/posts\/98810\/revisions\/98828"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/opensource.microsoft.com\/blog\/wp-json\/wp\/v2\/media\/98812"}],"wp:attachment":[{"href":"https:\/\/opensource.microsoft.com\/blog\/wp-json\/wp\/v2\/media?parent=98810"}],"wp:term":[{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/opensource.microsoft.com\/blog\/wp-json\/wp\/v2\/tags?post=98810"},{"taxonomy":"programming-languages","embeddable":true,"href":"https:\/\/opensource.microsoft.com\/blog\/wp-json\/wp\/v2\/programming-languages?post=98810"},{"taxonomy":"content-type","embeddable":true,"href":"https:\/\/opensource.microsoft.com\/blog\/wp-json\/wp\/v2\/content-type?post=98810"},{"taxonomy":"job-role","embeddable":true,"href":"https:\/\/opensource.microsoft.com\/blog\/wp-json\/wp\/v2\/job-role?post=98810"},{"taxonomy":"topic","embeddable":true,"href":"https:\/\/opensource.microsoft.com\/blog\/wp-json\/wp\/v2\/topic?post=98810"},{"taxonomy":"author","embeddable":true,"href":"https:\/\/opensource.microsoft.com\/blog\/wp-json\/wp\/v2\/coauthors?post=98810"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}