Skip to content

Commit dd08335

Browse files
Merge pull request #310580 from varuntha-MSFT/patch-32
(AzureCXP) fixes MicrosoftDocs/azure-docs-pr#545405
2 parents 4f67a37 + e488520 commit dd08335

1 file changed

Lines changed: 4 additions & 0 deletions

File tree

articles/api-management/api-management-api-import-restrictions.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -64,6 +64,10 @@ API Management only supports:
6464
- OpenAPI version 3.0.x (up to version 3.0.3)
6565
- OpenAPI version 3.1 (import only)
6666

67+
> [!NOTE]
68+
> API Management does not fully support OpenAPI 3.1. The platform allows 3.1 documents to be *imported*, but most 3.1-specific constructs (such as updated JSON Schema, callbacks, links, examples, requestBodies, headers, and other components) are not processed or enforced. During import, unsupported features are ignored, downgraded to 3.0-equivalent behavior, or removed.
69+
> Because of this, OpenAPI 3.1 should be treated as **import-compatible only**, not feature-compatible. For full fidelity, use OpenAPI 2.0 or 3.0.x.
70+
6771
**Size limitations**
6872

6973
| Size limit | Description |

0 commit comments

Comments
 (0)