{"id":1769,"date":"2019-01-23T00:00:00","date_gmt":"2019-01-23T00:00:00","guid":{"rendered":"https:\/\/azure.microsoft.com\/blog\/announcing-the-preview-of-openapi-specification-v3-support-in-azure-api-management"},"modified":"2025-06-11T05:01:53","modified_gmt":"2025-06-11T12:01:53","slug":"announcing-the-preview-of-openapi-specification-v3-support-in-azure-api-management","status":"publish","type":"post","link":"https:\/\/azure.microsoft.com\/en-us\/blog\/announcing-the-preview-of-openapi-specification-v3-support-in-azure-api-management\/","title":{"rendered":"Announcing the preview of OpenAPI Specification v3 support in Azure API Management"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">Azure API Management has just introduced preview support of <a href=\"https:\/\/www.openapis.org\/\" target=\"_blank\" rel=\"noopener\">OpenAPI Specification<\/a> v3 \u2013 the latest version of the broadly used <a href=\"https:\/\/github.com\/OAI\/OpenAPI-Specification\/blob\/master\/examples\/v3.0\/petstore-expanded.yaml\" target=\"_blank\" rel=\"noopener\">open-source<\/a> standard of describing APIs. Implementation of the feature is based on the <a href=\"https:\/\/github.com\/Microsoft\/OpenAPI.NET\" target=\"_blank\" rel=\"noopener\">OpenAPI.NET SDK<\/a>.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">In this blog post we will explore:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li class=\"wp-block-list-item\">The benefits of using OpenAPI Specification for your APIs.<\/li>\n\n\n\n<li class=\"wp-block-list-item\">How you can create APIs from OpenAPI Specification documents in Azure API Management.<\/li>\n\n\n\n<li class=\"wp-block-list-item\">How you can export your APIs as OpenAPI Specification documents.<\/li>\n\n\n\n<li class=\"wp-block-list-item\">The remaining work for the general availability release.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"why-you-should-use-openapi-specification-for-your-apis\">Why you should use OpenAPI Specification for your APIs<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">OpenAPI Specification is a <strong>widely adopted industry standard<\/strong>. The OpenAPI Initiative has been <a href=\"https:\/\/www.openapis.org\/membership\/members\" target=\"_blank\" rel=\"noopener\">backed by over 30 companies<\/a>, including large corporations such as Microsoft.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">OpenAPI Specification lets you <strong>abstract your APIs from their implementation<\/strong>. The API definitions are <strong>language-agnostic<\/strong>.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">They are also <strong>easy to understand, yet precise<\/strong>. Your APIs are represented through YAML or JSON files, readable for humans as well as machines.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The wide adoption of OpenAPI Specification has resulted in an <strong>extensive tooling ecosystem<\/strong>. Functionality of the tools ranges from facilitating collaborative process of designing APIs, to automatically generating client SDKs and server implementations in popular programming languages.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"how-to-import-openapi-specification-v3-definitions-in-azure-api-management\">How to import OpenAPI Specification v3 definitions in Azure API Management<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">If your APIs are defined in an OpenAPI Specification file, you can easily import them in Azure API Management. The Azure portal will automatically recognize the right version of your OpenAPI Specification files. You can learn how to import your APIs through the visual interface by following our tutorial, \u201c<a href=\"https:\/\/docs.microsoft.com\/en-us\/azure\/api-management\/import-and-publish\" target=\"_blank\" rel=\"noopener\">Import and publish your first API<\/a>.\u201d<\/p>\n\n\n\n<figure class=\"wp-block-image has-custom-border\"><img decoding=\"async\" src=\"https:\/\/azure.microsoft.com\/en-us\/blog\/wp-content\/uploads\/2019\/01\/4ac0d56c-14f8-4c9f-a43a-5e1c209f7d2e.webp\" alt=\"Importing APIs in Microsoft Azure\" style=\"border-radius:0px\" title=\"Importing APIs in Microsoft Azure\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Alternatively, you can import APIs using the <a href=\"https:\/\/docs.microsoft.com\/en-us\/rest\/api\/apimanagement\/apis\/createorupdate#apimanagementcreateapiusingoai3import\" target=\"_blank\" rel=\"noopener\">REST API call<\/a>, with the <a href=\"https:\/\/docs.microsoft.com\/en-us\/rest\/api\/apimanagement\/apis\/createorupdate#contentformat\" target=\"_blank\" rel=\"noopener\"><em>contentFormat<\/em> payload parameter<\/a> set to <em>openapi<\/em>, <em>openapi+json<\/em>, or <em>openapi-link<\/em>.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">During import, if the <em>servers<\/em> field of the specification contains multiple entries, API Management will select the first HTTPS URL. If there aren&#8217;t any HTTPS URLs, the first HTTP URL will be selected. If there aren&#8217;t any HTTP URLs, the backend service URL will be empty.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The import functionality has a <a href=\"https:\/\/docs.microsoft.com\/en-us\/azure\/api-management\/api-management-api-import-restrictions#a-nameopen-api-aopenapiswagger\" target=\"_blank\" rel=\"noopener\">few restrictions<\/a>. For example, it does not support <em>examples<\/em> and<em> multipart\/form-data<\/em> fields.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"how-to-export-openapi-specification-v3-definitions-in-azure-api-management\">How to export OpenAPI Specification v3 definitions in Azure API Management<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">With Azure API Management, you can also easily export your APIs in the OpenAPI Specification v3 format.<\/p>\n\n\n\n<figure class=\"wp-block-image has-custom-border\"><img decoding=\"async\" src=\"https:\/\/azure.microsoft.com\/en-us\/blog\/wp-content\/uploads\/2019\/01\/a2a30e1b-e085-4b55-9bf7-3ff5e69ea154.webp\" alt=\"API Management portal\" style=\"border-radius:0px\" title=\"API Management portal\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">API specifications can be downloaded from your developer portal as JSON or YAML files. The developer portal is an automatically generated, fully customizable website, where visitors can discover APIs, learn how to use them, try them out interactively, and finally sign up to acquire API keys.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">You can also export the specifications through the visual interface of the Azure portal or a <a href=\"https:\/\/docs.microsoft.com\/en-us\/rest\/api\/apimanagement\/apiexport\/get#exportformat\" target=\"_blank\" rel=\"noopener\">REST API call<\/a>, with the format query parameter set to <em>openapi-link<\/em>.<\/p>\n\n\n\n<figure class=\"wp-block-image has-custom-border\"><img decoding=\"async\" src=\"https:\/\/azure.microsoft.com\/en-us\/blog\/wp-content\/uploads\/2019\/01\/bf7d1f4a-c807-4979-bf27-3de6f70af790.webp\" alt=\"Exporting APIs\" style=\"border-radius:0px\" title=\"Exporting APIs\" \/><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"how-to-get-started-and-what-s-coming-next\">How to get started and what\u2019s coming next<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">You can try the current functionality in a matter of minutes by <a href=\"https:\/\/docs.microsoft.com\/en-us\/azure\/api-management\/import-and-publish\" target=\"_blank\" rel=\"noopener\">importing your APIs<\/a> from OpenAPI Specification files. Before the feature becomes generally available, we will implement export in a JSON format through a REST API call. In the coming months, we will also add OpenAPI Specification v3 import and export support in the PowerShell SDK.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><a href=\"https:\/\/aka.ms\/apimso\">Let us know what you think<\/a>!&nbsp;<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Azure API Management has just introduced preview support of OpenAPI Specification v3 \u2013 the latest version of the broadly used open-source standard of describing APIs. Implementation of the feature is based on the OpenAPI.NET SDK.<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"ms_queue_id":[],"ep_exclude_from_search":false,"_classifai_error":"","_classifai_text_to_speech_error":"","_alt_title":"","footnotes":"","msx_community_cta_settings":[]},"categories":[1498,1485,1556,1461],"tags":[],"audience":[3054,3055,3056],"content-type":[1465],"product":[1499],"tech-community":[],"topic":[],"coauthors":[643],"class_list":["post-1769","post","type-post","status-publish","format-standard","hentry","category-integration","category-internet-of-things","category-mobile","category-web","audience-business-decision-makers","audience-developers","audience-it-implementors","content-type-announcements","product-api-management","review-flag-1680286581-295","review-flag-1680286581-364","review-flag-gener-1680286584-335"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v27.2 - https:\/\/yoast.com\/product\/yoast-seo-wordpress\/ -->\n<title>Announcing the preview of OpenAPI Specification v3 support in Azure API Management | Microsoft Azure Blog<\/title>\n<meta name=\"description\" content=\"Azure API Management has just introduced preview support of OpenAPI Specification v3 \u2013 the latest version of the broadly used open-source standard of describing APIs. Implementation of the feature is based on the OpenAPI.NET SDK.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/azure.microsoft.com\/en-us\/blog\/announcing-the-preview-of-openapi-specification-v3-support-in-azure-api-management\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Announcing the preview of OpenAPI Specification v3 support in Azure API Management | Microsoft Azure Blog\" \/>\n<meta property=\"og:description\" content=\"Azure API Management has just introduced preview support of OpenAPI Specification v3 \u2013 the latest version of the broadly used open-source standard of describing APIs. Implementation of the feature is based on the OpenAPI.NET SDK.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/azure.microsoft.com\/en-us\/blog\/announcing-the-preview-of-openapi-specification-v3-support-in-azure-api-management\/\" \/>\n<meta property=\"og:site_name\" content=\"Microsoft Azure Blog\" \/>\n<meta property=\"article:publisher\" content=\"https:\/\/www.facebook.com\/microsoftazure\" \/>\n<meta property=\"article:published_time\" content=\"2019-01-23T00:00:00+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2025-06-11T12:01:53+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/azure.microsoft.com\/en-us\/blog\/wp-content\/uploads\/2019\/01\/4ac0d56c-14f8-4c9f-a43a-5e1c209f7d2e.webp\" \/>\n<meta name=\"author\" content=\"Mike Budzynski\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:creator\" content=\"@azure\" \/>\n<meta name=\"twitter:site\" content=\"@azure\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Mike Budzynski\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"3 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\/\/azure.microsoft.com\/en-us\/blog\/announcing-the-preview-of-openapi-specification-v3-support-in-azure-api-management\/#article\",\"isPartOf\":{\"@id\":\"https:\/\/azure.microsoft.com\/en-us\/blog\/announcing-the-preview-of-openapi-specification-v3-support-in-azure-api-management\/\"},\"author\":[{\"@id\":\"https:\/\/azure.microsoft.com\/en-us\/blog\/author\/mike-budzynski\/\",\"@type\":\"Person\",\"@name\":\"Mike Budzynski\"}],\"headline\":\"Announcing the preview of OpenAPI Specification v3 support in Azure API Management\",\"datePublished\":\"2019-01-23T00:00:00+00:00\",\"dateModified\":\"2025-06-11T12:01:53+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\/\/azure.microsoft.com\/en-us\/blog\/announcing-the-preview-of-openapi-specification-v3-support-in-azure-api-management\/\"},\"wordCount\":530,\"commentCount\":0,\"publisher\":{\"@id\":\"https:\/\/azure.microsoft.com\/en-us\/blog\/#organization\"},\"image\":{\"@id\":\"https:\/\/azure.microsoft.com\/en-us\/blog\/announcing-the-preview-of-openapi-specification-v3-support-in-azure-api-management\/#primaryimage\"},\"thumbnailUrl\":\"https:\/\/azure.microsoft.com\/en-us\/blog\/wp-content\/uploads\/2019\/01\/4ac0d56c-14f8-4c9f-a43a-5e1c209f7d2e.webp\",\"articleSection\":[\"Integration\",\"Internet of things\",\"Mobile\",\"Web\"],\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"CommentAction\",\"name\":\"Comment\",\"target\":[\"https:\/\/azure.microsoft.com\/en-us\/blog\/announcing-the-preview-of-openapi-specification-v3-support-in-azure-api-management\/#respond\"]}]},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/azure.microsoft.com\/en-us\/blog\/announcing-the-preview-of-openapi-specification-v3-support-in-azure-api-management\/\",\"url\":\"https:\/\/azure.microsoft.com\/en-us\/blog\/announcing-the-preview-of-openapi-specification-v3-support-in-azure-api-management\/\",\"name\":\"Announcing the preview of OpenAPI Specification v3 support in Azure API Management | Microsoft Azure Blog\",\"isPartOf\":{\"@id\":\"https:\/\/azure.microsoft.com\/en-us\/blog\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/azure.microsoft.com\/en-us\/blog\/announcing-the-preview-of-openapi-specification-v3-support-in-azure-api-management\/#primaryimage\"},\"image\":{\"@id\":\"https:\/\/azure.microsoft.com\/en-us\/blog\/announcing-the-preview-of-openapi-specification-v3-support-in-azure-api-management\/#primaryimage\"},\"thumbnailUrl\":\"https:\/\/azure.microsoft.com\/en-us\/blog\/wp-content\/uploads\/2019\/01\/4ac0d56c-14f8-4c9f-a43a-5e1c209f7d2e.webp\",\"datePublished\":\"2019-01-23T00:00:00+00:00\",\"dateModified\":\"2025-06-11T12:01:53+00:00\",\"description\":\"Azure API Management has just introduced preview support of OpenAPI Specification v3 \u2013 the latest version of the broadly used open-source standard of describing APIs. Implementation of the feature is based on the OpenAPI.NET SDK.\",\"breadcrumb\":{\"@id\":\"https:\/\/azure.microsoft.com\/en-us\/blog\/announcing-the-preview-of-openapi-specification-v3-support-in-azure-api-management\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/azure.microsoft.com\/en-us\/blog\/announcing-the-preview-of-openapi-specification-v3-support-in-azure-api-management\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/azure.microsoft.com\/en-us\/blog\/announcing-the-preview-of-openapi-specification-v3-support-in-azure-api-management\/#primaryimage\",\"url\":\"https:\/\/azure.microsoft.com\/en-us\/blog\/wp-content\/uploads\/2019\/01\/4ac0d56c-14f8-4c9f-a43a-5e1c209f7d2e.webp\",\"contentUrl\":\"https:\/\/azure.microsoft.com\/en-us\/blog\/wp-content\/uploads\/2019\/01\/4ac0d56c-14f8-4c9f-a43a-5e1c209f7d2e.webp\"},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/azure.microsoft.com\/en-us\/blog\/announcing-the-preview-of-openapi-specification-v3-support-in-azure-api-management\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Blog home\",\"item\":\"https:\/\/azure.microsoft.com\/en-us\/blog\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Integration\",\"item\":\"https:\/\/azure.microsoft.com\/en-us\/blog\/category\/integration\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Announcing the preview of OpenAPI Specification v3 support in Azure API Management\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/azure.microsoft.com\/en-us\/blog\/#website\",\"url\":\"https:\/\/azure.microsoft.com\/en-us\/blog\/\",\"name\":\"Microsoft Azure Blog\",\"description\":\"Get the latest Azure news, updates, and announcements from the Azure blog. From product updates to hot topics, hear from the Azure experts.\",\"publisher\":{\"@id\":\"https:\/\/azure.microsoft.com\/en-us\/blog\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/azure.microsoft.com\/en-us\/blog\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/azure.microsoft.com\/en-us\/blog\/#organization\",\"name\":\"Microsoft Azure Blog\",\"url\":\"https:\/\/azure.microsoft.com\/en-us\/blog\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/azure.microsoft.com\/en-us\/blog\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/azure.microsoft.com\/en-us\/blog\/wp-content\/uploads\/2024\/06\/microsoft_logo.webp\",\"contentUrl\":\"https:\/\/azure.microsoft.com\/en-us\/blog\/wp-content\/uploads\/2024\/06\/microsoft_logo.webp\",\"width\":512,\"height\":512,\"caption\":\"Microsoft Azure Blog\"},\"image\":{\"@id\":\"https:\/\/azure.microsoft.com\/en-us\/blog\/#\/schema\/logo\/image\/\"},\"sameAs\":[\"https:\/\/www.facebook.com\/microsoftazure\",\"https:\/\/x.com\/azure\",\"https:\/\/www.instagram.com\/microsoftdeveloper\/\",\"https:\/\/www.linkedin.com\/company\/16188386\",\"https:\/\/www.youtube.com\/user\/windowsazure\"]},{\"@type\":\"Person\",\"@id\":\"https:\/\/azure.microsoft.com\/en-us\/blog\/#\/schema\/person\/c702e5edd662b328b49b7e1180cab117\",\"name\":\"shakir\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/secure.gravatar.com\/avatar\/9342c7c05bb16548741bc5cd3a3e3b7ee0c8e746844ad2cc582db5beb5514c6f?s=96&d=mm&r=g7664e653ea371ce16eaf75e9fa8952c4\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/9342c7c05bb16548741bc5cd3a3e3b7ee0c8e746844ad2cc582db5beb5514c6f?s=96&d=mm&r=g\",\"contentUrl\":\"https:\/\/secure.gravatar.com\/avatar\/9342c7c05bb16548741bc5cd3a3e3b7ee0c8e746844ad2cc582db5beb5514c6f?s=96&d=mm&r=g\",\"caption\":\"shakir\"},\"sameAs\":[\"https:\/\/azure.microsoft.com\"],\"url\":\"https:\/\/azure.microsoft.com\/en-us\/blog\/author\/shakir\/\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Announcing the preview of OpenAPI Specification v3 support in Azure API Management | Microsoft Azure Blog","description":"Azure API Management has just introduced preview support of OpenAPI Specification v3 \u2013 the latest version of the broadly used open-source standard of describing APIs. Implementation of the feature is based on the OpenAPI.NET SDK.","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:\/\/azure.microsoft.com\/en-us\/blog\/announcing-the-preview-of-openapi-specification-v3-support-in-azure-api-management\/","og_locale":"en_US","og_type":"article","og_title":"Announcing the preview of OpenAPI Specification v3 support in Azure API Management | Microsoft Azure Blog","og_description":"Azure API Management has just introduced preview support of OpenAPI Specification v3 \u2013 the latest version of the broadly used open-source standard of describing APIs. Implementation of the feature is based on the OpenAPI.NET SDK.","og_url":"https:\/\/azure.microsoft.com\/en-us\/blog\/announcing-the-preview-of-openapi-specification-v3-support-in-azure-api-management\/","og_site_name":"Microsoft Azure Blog","article_publisher":"https:\/\/www.facebook.com\/microsoftazure","article_published_time":"2019-01-23T00:00:00+00:00","article_modified_time":"2025-06-11T12:01:53+00:00","og_image":[{"url":"https:\/\/azure.microsoft.com\/en-us\/blog\/wp-content\/uploads\/2019\/01\/4ac0d56c-14f8-4c9f-a43a-5e1c209f7d2e.webp","type":"","width":"","height":""}],"author":"Mike Budzynski","twitter_card":"summary_large_image","twitter_creator":"@azure","twitter_site":"@azure","twitter_misc":{"Written by":"Mike Budzynski","Est. reading time":"3 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/azure.microsoft.com\/en-us\/blog\/announcing-the-preview-of-openapi-specification-v3-support-in-azure-api-management\/#article","isPartOf":{"@id":"https:\/\/azure.microsoft.com\/en-us\/blog\/announcing-the-preview-of-openapi-specification-v3-support-in-azure-api-management\/"},"author":[{"@id":"https:\/\/azure.microsoft.com\/en-us\/blog\/author\/mike-budzynski\/","@type":"Person","@name":"Mike Budzynski"}],"headline":"Announcing the preview of OpenAPI Specification v3 support in Azure API Management","datePublished":"2019-01-23T00:00:00+00:00","dateModified":"2025-06-11T12:01:53+00:00","mainEntityOfPage":{"@id":"https:\/\/azure.microsoft.com\/en-us\/blog\/announcing-the-preview-of-openapi-specification-v3-support-in-azure-api-management\/"},"wordCount":530,"commentCount":0,"publisher":{"@id":"https:\/\/azure.microsoft.com\/en-us\/blog\/#organization"},"image":{"@id":"https:\/\/azure.microsoft.com\/en-us\/blog\/announcing-the-preview-of-openapi-specification-v3-support-in-azure-api-management\/#primaryimage"},"thumbnailUrl":"https:\/\/azure.microsoft.com\/en-us\/blog\/wp-content\/uploads\/2019\/01\/4ac0d56c-14f8-4c9f-a43a-5e1c209f7d2e.webp","articleSection":["Integration","Internet of things","Mobile","Web"],"inLanguage":"en-US","potentialAction":[{"@type":"CommentAction","name":"Comment","target":["https:\/\/azure.microsoft.com\/en-us\/blog\/announcing-the-preview-of-openapi-specification-v3-support-in-azure-api-management\/#respond"]}]},{"@type":"WebPage","@id":"https:\/\/azure.microsoft.com\/en-us\/blog\/announcing-the-preview-of-openapi-specification-v3-support-in-azure-api-management\/","url":"https:\/\/azure.microsoft.com\/en-us\/blog\/announcing-the-preview-of-openapi-specification-v3-support-in-azure-api-management\/","name":"Announcing the preview of OpenAPI Specification v3 support in Azure API Management | Microsoft Azure Blog","isPartOf":{"@id":"https:\/\/azure.microsoft.com\/en-us\/blog\/#website"},"primaryImageOfPage":{"@id":"https:\/\/azure.microsoft.com\/en-us\/blog\/announcing-the-preview-of-openapi-specification-v3-support-in-azure-api-management\/#primaryimage"},"image":{"@id":"https:\/\/azure.microsoft.com\/en-us\/blog\/announcing-the-preview-of-openapi-specification-v3-support-in-azure-api-management\/#primaryimage"},"thumbnailUrl":"https:\/\/azure.microsoft.com\/en-us\/blog\/wp-content\/uploads\/2019\/01\/4ac0d56c-14f8-4c9f-a43a-5e1c209f7d2e.webp","datePublished":"2019-01-23T00:00:00+00:00","dateModified":"2025-06-11T12:01:53+00:00","description":"Azure API Management has just introduced preview support of OpenAPI Specification v3 \u2013 the latest version of the broadly used open-source standard of describing APIs. Implementation of the feature is based on the OpenAPI.NET SDK.","breadcrumb":{"@id":"https:\/\/azure.microsoft.com\/en-us\/blog\/announcing-the-preview-of-openapi-specification-v3-support-in-azure-api-management\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/azure.microsoft.com\/en-us\/blog\/announcing-the-preview-of-openapi-specification-v3-support-in-azure-api-management\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/azure.microsoft.com\/en-us\/blog\/announcing-the-preview-of-openapi-specification-v3-support-in-azure-api-management\/#primaryimage","url":"https:\/\/azure.microsoft.com\/en-us\/blog\/wp-content\/uploads\/2019\/01\/4ac0d56c-14f8-4c9f-a43a-5e1c209f7d2e.webp","contentUrl":"https:\/\/azure.microsoft.com\/en-us\/blog\/wp-content\/uploads\/2019\/01\/4ac0d56c-14f8-4c9f-a43a-5e1c209f7d2e.webp"},{"@type":"BreadcrumbList","@id":"https:\/\/azure.microsoft.com\/en-us\/blog\/announcing-the-preview-of-openapi-specification-v3-support-in-azure-api-management\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Blog home","item":"https:\/\/azure.microsoft.com\/en-us\/blog\/"},{"@type":"ListItem","position":2,"name":"Integration","item":"https:\/\/azure.microsoft.com\/en-us\/blog\/category\/integration\/"},{"@type":"ListItem","position":3,"name":"Announcing the preview of OpenAPI Specification v3 support in Azure API Management"}]},{"@type":"WebSite","@id":"https:\/\/azure.microsoft.com\/en-us\/blog\/#website","url":"https:\/\/azure.microsoft.com\/en-us\/blog\/","name":"Microsoft Azure Blog","description":"Get the latest Azure news, updates, and announcements from the Azure blog. From product updates to hot topics, hear from the Azure experts.","publisher":{"@id":"https:\/\/azure.microsoft.com\/en-us\/blog\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/azure.microsoft.com\/en-us\/blog\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/azure.microsoft.com\/en-us\/blog\/#organization","name":"Microsoft Azure Blog","url":"https:\/\/azure.microsoft.com\/en-us\/blog\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/azure.microsoft.com\/en-us\/blog\/#\/schema\/logo\/image\/","url":"https:\/\/azure.microsoft.com\/en-us\/blog\/wp-content\/uploads\/2024\/06\/microsoft_logo.webp","contentUrl":"https:\/\/azure.microsoft.com\/en-us\/blog\/wp-content\/uploads\/2024\/06\/microsoft_logo.webp","width":512,"height":512,"caption":"Microsoft Azure Blog"},"image":{"@id":"https:\/\/azure.microsoft.com\/en-us\/blog\/#\/schema\/logo\/image\/"},"sameAs":["https:\/\/www.facebook.com\/microsoftazure","https:\/\/x.com\/azure","https:\/\/www.instagram.com\/microsoftdeveloper\/","https:\/\/www.linkedin.com\/company\/16188386","https:\/\/www.youtube.com\/user\/windowsazure"]},{"@type":"Person","@id":"https:\/\/azure.microsoft.com\/en-us\/blog\/#\/schema\/person\/c702e5edd662b328b49b7e1180cab117","name":"shakir","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/secure.gravatar.com\/avatar\/9342c7c05bb16548741bc5cd3a3e3b7ee0c8e746844ad2cc582db5beb5514c6f?s=96&d=mm&r=g7664e653ea371ce16eaf75e9fa8952c4","url":"https:\/\/secure.gravatar.com\/avatar\/9342c7c05bb16548741bc5cd3a3e3b7ee0c8e746844ad2cc582db5beb5514c6f?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/9342c7c05bb16548741bc5cd3a3e3b7ee0c8e746844ad2cc582db5beb5514c6f?s=96&d=mm&r=g","caption":"shakir"},"sameAs":["https:\/\/azure.microsoft.com"],"url":"https:\/\/azure.microsoft.com\/en-us\/blog\/author\/shakir\/"}]}},"msxcm_display_generated_audio":false,"msxcm_animated_featured_image":null,"distributor_meta":false,"distributor_terms":false,"distributor_media":false,"distributor_original_site_name":"Microsoft Azure Blog","distributor_original_site_url":"https:\/\/azure.microsoft.com\/en-us\/blog","push-errors":false,"_links":{"self":[{"href":"https:\/\/azure.microsoft.com\/en-us\/blog\/wp-json\/wp\/v2\/posts\/1769","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/azure.microsoft.com\/en-us\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/azure.microsoft.com\/en-us\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/azure.microsoft.com\/en-us\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/azure.microsoft.com\/en-us\/blog\/wp-json\/wp\/v2\/comments?post=1769"}],"version-history":[{"count":1,"href":"https:\/\/azure.microsoft.com\/en-us\/blog\/wp-json\/wp\/v2\/posts\/1769\/revisions"}],"predecessor-version":[{"id":41399,"href":"https:\/\/azure.microsoft.com\/en-us\/blog\/wp-json\/wp\/v2\/posts\/1769\/revisions\/41399"}],"wp:attachment":[{"href":"https:\/\/azure.microsoft.com\/en-us\/blog\/wp-json\/wp\/v2\/media?parent=1769"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/azure.microsoft.com\/en-us\/blog\/wp-json\/wp\/v2\/categories?post=1769"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/azure.microsoft.com\/en-us\/blog\/wp-json\/wp\/v2\/tags?post=1769"},{"taxonomy":"audience","embeddable":true,"href":"https:\/\/azure.microsoft.com\/en-us\/blog\/wp-json\/wp\/v2\/audience?post=1769"},{"taxonomy":"content-type","embeddable":true,"href":"https:\/\/azure.microsoft.com\/en-us\/blog\/wp-json\/wp\/v2\/content-type?post=1769"},{"taxonomy":"product","embeddable":true,"href":"https:\/\/azure.microsoft.com\/en-us\/blog\/wp-json\/wp\/v2\/product?post=1769"},{"taxonomy":"tech-community","embeddable":true,"href":"https:\/\/azure.microsoft.com\/en-us\/blog\/wp-json\/wp\/v2\/tech-community?post=1769"},{"taxonomy":"topic","embeddable":true,"href":"https:\/\/azure.microsoft.com\/en-us\/blog\/wp-json\/wp\/v2\/topic?post=1769"},{"taxonomy":"author","embeddable":true,"href":"https:\/\/azure.microsoft.com\/en-us\/blog\/wp-json\/wp\/v2\/coauthors?post=1769"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}