OpenAPI 3.2 is here: what's new and how Redocly supports it

OpenAPI 3.2, released in September 2025, introduces several enhancements such as support for streaming APIs, hierarchical tags, new HTTP methods, and updated security flows, all while maintaining backward compatibility with previous versions. The release simplifies navigation in larger APIs by allowing tags to be organized hierarchically, a feature similar to Redocly's x-tagGroups extension. It also introduces support for streaming media types like text/event-stream and application/jsonl with a new itemSchema field for describing each stream item's shape. The QUERY method is now supported, suitable for complex search operations, and additional HTTP methods can be specified with the new additionalOperations field. Security updates include support for OAuth 2.0 Device Authorization Flow and the ability to mark security schemes as deprecated. New example fields, dataValue and serializedValue, help clarify the structured data and serialized representations, especially for encoded parameters. Other noteworthy features include a new queryString parameter location, XML nodeType mapping, and defaultMapping on discriminators. Redocly fully supports OpenAPI 3.2, allowing users to seamlessly upgrade and utilize these new features without disrupting existing implementations.