NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm, #4542 most downloaded on npm
Convert OpenAPI 3.0 & 3.1 schemas to TypeScript
Latest stable
7.13.0
Last release 9 months ago
11 Feb 2026
Release timing varies
gaps range from 2 weeks to 4 months
Nearly every release is documented
notes for 58 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
6 years old
156 releases · first in 2020
Drag across the ruler to compare, or tap a release to open it.
Nothing published for this version
Nothing published for this version
Schema objects that have a default: property shouldn’t be marked as nullable
🐛 Bugfixes
default: property shouldn’t be marked as nullable (#613)default: property shouldn’t be marked as nullable (#613)Your coding agent can read these notes before it upgrades. Set up the MCP server →
Changes default behavior of #585 to require an opt-in --additional-properties flag
🐣 Minor changes
--additional-properties flag (#607)-c shortcut alias for --prettier-config (#607)-it shortcut alias for --immutable-types (#607)Nothing published for this version
additionalProperties now default to true per the OpenAPI 3.0 spec by @mehalter
🐛 Bugfixes
additionalProperties now default to true per the OpenAPI 3.0 spec by @mehalter (#583)additionalProperties now default to true per the OpenAPI 3.0 spec by @mehalter (#583)Fixed a parse error on enum: []
🐛 Bugfixes
enum: [] (#563)options.prettierConfig (#566)RequestBodies that had hyphens in their name would generate an error (#550). Thanks (again), @ashsmith!
🐛 Bugfixes
Fixed an issue where a comment within a schema definition would break type gen (#548). Thanks, @ashsmith!
🐛 Bugfixes
Added a new --immutable-types flag to generate readonly schemas by @dnalborczyk
✨ New features
--immutable-types flag to generate readonly schemas by @dnalborczyk (#522)operations interface has been improved with inherited parameters by @henhal (#530)--immutable-types flag by @dnalborczyk (#522)operations interface inherits parameters properly by @henhal (#530)Fixes package types for TypeScript projects
🐛 Bugfixes
Better handles remote schema content types
🐛 Bugfixes
Remote schema loading now follows redirects
✨ New features
--auth flag to access private schemas (#508)🐛 Bugfixes
📝 Other Notes
--auth flag to access private schemas (#508)Nothing published for this version
Nothing published for this version
If using OpenAPI 2.0, and you didn’t have definitions, an unexpected error was encountered. This is now fixed.
🐛 Bugfixes
definitions, an unexpected error was encountered. This is now fixed.Improves handling of complex oneOf by @gr2m
🐛 Bugfixes
oneOf by @gr2m (#491)Fixed requestBodies transform by @radist2s
🐛 Bugfixes
null by @FedeBev (#492)Fixed generation bug where responseBodies that contained both a $ref and operationId generated invalid TypeScript
🐛 Bugfixes
responseBodies that contained both a $ref and operationId generated invalid TypeScript (#464)$ref and operationId generated invalid TypeScript (#464)Adds long-requested paths support to Swagger v2 schemas
✨ Features
paths support to Swagger v2 schemas🐛 Bugfixes
paths generation (missing $refs support in areas, inconsistent generation)⚠️ Breaking changes
3.0.0 with no problems; OpenAPI v3 users will either experience no changes or minor changes that should be an overall improvement.📝 Other Notes
2.x of this library, OpenAPI v3 support was added, and it was a separate part of the codebase. This major release combines Swagger v2 and OpenAPI v3 code together. Though they are different schemas, they have much more in common than they do in difference. Combining the code will make this library easier to maintain, easier to test, and more stable overall.3.0.0 with no problems; OpenAPI v3 users will either experience no changes or minor changes that should be an overall improvement.Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Comments can now be single-line, saving some needed space in the specs
🐥 Minor Changes
🐛 Bugfixes
additionalProperties.oneOf is now generating as expected (#442)additionalProperties.oneOf is now generating as expected (#442)Fixes paths.requestBody.content possibly missing by @robertmassaioli
🐛 Bugfixes
paths.requestBody.content possibly missing by @robertmassaioli (#369)https://github.com/drwpow/openapi-typescript/compare/v2.4.1...v2.4.2
paths.requestBody.content possibly missing by @robertmassaioli (#369)fix: escape quotes in enum string values (#365) by @gr2m 55bc785
🐛 Bugfixes
https://github.com/drwpow/openapi-typescript/compare/v2.4.0...v2.4.1
Do you have really complicated response objects that are a pain in the butt to reference in TS? Good news! There‘s a new operations interface by @gr2m
🐸 New features
operations interface by @gr2m that you can use, and it doesn‘t affect the existing API (#353) bf009b7https://github.com/drwpow/openapi-typescript/compare/v2.3.4...v2.4.0
Allow $ref: 'foo.yaml#bar' syntax, but cast to any type (TODO: full external schema support)
🐛 Bugfixes
$ref: 'foo.yaml#bar' syntax, but cast to any type (TODO: full external schema support) (#354)https://github.com/drwpow/openapi-typescript/compare/v2.3.3...v2.3.4
$ref: 'foo.yaml#bar' syntax, but cast to any type (TODO: full external schema support) (#354)@gr2m: $refs in paths now respect optional parameters (#352) fcdd8b9
🐛 Bugfixes
$refs in paths now respect optional parameters (#352) fcdd8b9https://github.com/drwpow/openapi-typescript/compare/v2.3.2...v2.3.3
$refs in paths now respect optional parameters (#352) by @gr2mHandle parameters on paths as well as methods by @samdbmg
🐛 Bugfixes
https://github.com/drwpow/openapi-typescript/compare/v2.3.1...v2.3.2
Set index type to all possible values
🐛 Bugfixes
https://github.com/drwpow/openapi-typescript/compare/v2.3.0...v2.3.1
requestBody and $ref-type parameters added in response types by @gr2m
🐸 New Features
requestBody and $ref-type parameters added in response types by @gr2m🐣 Minor Changes
any to never or unknown by @gr2mhttps://github.com/drwpow/openapi-typescript/compare/v2.2.1...v2.3.0
Nothing published for this version
New name! Now published at openapi-typescript.
🦍 Major changes
openapi-typescript.🐣 Minor improvements
openapi-typescript.One column per quarter.