Microsoft details contributions to OpenAPI and JSON Schema standards

Microsoft has outlined its ongoing work with open specifications, specifically focusing on OpenAPI and JSON Schema. The company is utilizing these standards to improve the precision of API descriptions, which is critical for the reliability of code generated by large language models. The update highlights how these specifications are integrated into Microsoft Foundry to automate SDK generation and contract testing.

Technical advancements in API specifications

• OpenAPI 3.2.0 introduces HTTP QUERY support, device flow support for security, and streaming data capabilities.
• JSON Schema 2020-12 adds support for $dynamicRef/Anchor, enabling recursive schemas without brittle $ref chains.
• Microsoft uses TypeSpec to convert OpenAPI descriptions into definitions for generating SDKs, API references, and server-side code.
• Integration with Visual Studio Code via Schema Store supports developer workflows using these updated schemas.

Why it matters

Standardizing API descriptions through OpenAPI and JSON Schema improves the interoperability of tools and the accuracy of AI-generated code in agentic development environments.