Discover what's new in OpenAPI 3.2.0, including streaming responses, extended HTTP methods, clearer examples, and OAuth device flow updates.

Nordic APIs's resource offers insights, tutorials, and resources for API developers and architects. Readers can learn about API design principles, security practices, and API management strategies. With articles, webinars, and industry reports, Nordic APIs provides  guidance and expertise for building and managing APIs that power modern applications and digital ecosystems.

Nordic APIs

OpenAPI 3.2.0 introduces incremental but significant improvements to the API specification standard. Key updates include first-class support for streaming media types (text/event-stream, application/jsonl) with schema definitions for individual stream items, hierarchical tag organization for better API navigation, support for extended HTTP methods including the QUERY method through additionalOperations, clarified path templating semantics for consistent routing across tools, clearer example semantics distinguishing data-level from serialized representations, and explicit OAuth 2.0 Device Authorization Flow support. These changes standardize patterns that previously required vendor extensions, making the specification more expressive for modern API designs while maintaining backward compatibility.

What’s New in OpenAPI Specification v3.2.0?

Structured Tags and Hierarchical Organization

First-Class Support for Streaming Media Types

OpenAPI 3.2.0 Extends HTTP Methods and additionalOperations

Clarified Path Templating and Routing Semantics

Clearer Example Semantics for Data and Serialization

OAuth 2.0 Device Flow and Security Metadata Updates