Skip to content

Releases: speakeasy-api/openapi

v1.12.3

11 Dec 07:04
de50921

Choose a tag to compare

What's Changed

  • fix: fixed json conversion from yaml to json by @TristanSpeakEasy in #102
  • chore(cmd): update openapi dependency to latest main by @github-actions[bot] in #103

Full Changelog: v1.12.2...v1.12.3

OpenAPI CLI v1.12.3

This release includes binaries for Linux, macOS, and Windows on both x86_64 and ARM64 architectures.

Installation

Download the appropriate binary for your platform from the assets below, extract it, and add it to your PATH.

Changes

Changelog

Bug fixes

  • 722ae45 fix: fixed json conversion from yaml to json (#102)

Others

  • de50921 chore(cmd): update openapi dependency to latest main (#103)

Full Changelog: v1.12.2...v1.12.3

Released by GoReleaser.

v1.12.2

11 Dec 04:34
7ebd2ee

Choose a tag to compare

What's Changed

  • fix: fixed validation of reference names to prevent empty and illegal references by @TristanSpeakEasy in #100
  • chore(cmd): update openapi dependency to latest main by @github-actions[bot] in #101

Full Changelog: v1.12.1...v1.12.2

OpenAPI CLI v1.12.2

This release includes binaries for Linux, macOS, and Windows on both x86_64 and ARM64 architectures.

Installation

Download the appropriate binary for your platform from the assets below, extract it, and add it to your PATH.

Changes

Changelog

Bug fixes

  • ee32c44 fix: fixed validation of reference names to prevent empty and illegal references (#100)

Others

  • 7ebd2ee chore(cmd): update openapi dependency to latest main (#101)

Full Changelog: v1.12.1...v1.12.2

Released by GoReleaser.

v1.12.1

10 Dec 13:49
86aea2f

Choose a tag to compare

What's Changed

  • fix: support overlay version 1.1.0 by @danielkov in #97
  • chore(cmd): update openapi dependency to latest main by @github-actions[bot] in #98

Full Changelog: v1.12.0...v1.12.1

OpenAPI CLI v1.12.1

This release includes binaries for Linux, macOS, and Windows on both x86_64 and ARM64 architectures.

Installation

Download the appropriate binary for your platform from the assets below, extract it, and add it to your PATH.

Changes

Changelog

Bug fixes

  • b241c5c fix: support overlay version 1.1.0 (#97)

Others

  • 86aea2f chore(cmd): update openapi dependency to latest main (#98)

Full Changelog: v1.12.0...v1.12.1

Released by GoReleaser.

v1.12.0

10 Dec 00:17
c1b2064

Choose a tag to compare

🎉 Major Feature: OpenAPI 3.2.0 Support

This release adds comprehensive support for the OpenAPI 3.2.0 specification, including all new fields and features introduced in the latest version.

✨ Features

OpenAPI 3.2.0 Specification Support

  • Add support for OpenAPI 3.2.0 specification
  • Add additionalOperations support for paths
  • Add tags array support in OpenAPI 3.2
  • Add querystring operation parameters support
  • Add itemSchema support for media types
  • Add prefixEncoding and itemEncoding support for multipart media types
  • Add discriminator defaultMapping support
  • Add security enhancements:
    • OAuth2 device authorization flow
    • deprecated field for security schemes
    • oauth2MetadataUrl support
    • URI-based security scheme references
  • Add dataValue and serializedValue support to Example Object
  • Add name field to Server Object
  • Add field support with reference resolution

Other Features

  • Add support for copy action
  • Update walk API to support 3.2 additionalOperations
  • Add inline/bundling tests for additional operations

�� Fixes

  • Prevent file content disclosure in validation error messages
  • Address PR feedback and various bug fixes
  • Fix mise CI test issues

📚 Documentation

  • Update documentation to reflect OpenAPI 3.2.0 support
  • Update version references from 3.1.x to 3.2.0
  • Add git commit conventions to AGENTS.md
  • Update README and OpenAPI logo

🔧 Maintenance

  • Update golangci and fix issues it found
  • Update openapi dependency to latest main

📦 Full Changelog

Full Changelog: v1.11.4...v1.12.0

OpenAPI CLI v1.12.0

This release includes binaries for Linux, macOS, and Windows on both x86_64 and ARM64 architectures.

Installation

Download the appropriate binary for your platform from the assets below, extract it, and add it to your PATH.

Changes

Changelog

Features

  • 09abb9d feat: Add support for 3.2.0 openapi spec (#54)

Others

  • c1b2064 chore(cmd): update openapi dependency to latest main (#90)

Full Changelog: v1.11.4...v1.12.0

Released by GoReleaser.

v1.11.4

08 Dec 23:36
d8d8765

Choose a tag to compare

What's Changed

  • feat: support copy action in overlay (#87)
  • chore(cmd): update openapi dependency to latest main (#88)

Full Changelog: v1.11.3...v1.11.4

OpenAPI CLI v1.11.4

This release includes binaries for Linux, macOS, and Windows on both x86_64 and ARM64 architectures.

Installation

Download the appropriate binary for your platform from the assets below, extract it, and add it to your PATH.

Changes

Changelog

Features

Others

  • d8d8765 chore(cmd): update openapi dependency to latest main (#88)

Full Changelog: v1.11.3...v1.11.4

Released by GoReleaser.

v1.11.3

08 Dec 05:56
cfefbfa

Choose a tag to compare

Bug Fixes

  • fix: preserve metadata in swagger to openapi upgrade (#84)

CI/Chore

  • ci: add workflow to auto-update cmd/openapi dependency (#85)
  • chore(cmd): update openapi dependency to latest main (#86)
  • chore(deps): bump jsonschema/oas3/tests/testsuite from 677a939 to d69537a (#81)

Full Changelog: v1.11.2...v1.11.3

OpenAPI CLI v1.11.3

This release includes binaries for Linux, macOS, and Windows on both x86_64 and ARM64 architectures.

Installation

Download the appropriate binary for your platform from the assets below, extract it, and add it to your PATH.

Changes

Changelog

Bug fixes

  • 3d74e45 fix: preserve metadata in swagger to openapi upgrade (#84)

Others

  • cfefbfa chore(cmd): update openapi dependency to latest main (#86)
  • 091b257 chore(deps): bump jsonschema/oas3/tests/testsuite from 677a939 to d69537a (#81)

Full Changelog: v1.11.2...v1.11.3

Released by GoReleaser.

v1.11.2

08 Dec 01:42

Choose a tag to compare

Fixed

  • Handle chained header references in bundle command (#83)

Dependencies

  • Bump golang.org/x/crypto in /jsonschema/oas3/tests (#82)
  • Bump the go-minor-patch group across 2 directories with 3 updates (#77)
  • Bump the github-actions group across 1 directory with 2 updates (#80)

Internal

OpenAPI CLI v1.11.2

This release includes binaries for Linux, macOS, and Windows on both x86_64 and ARM64 architectures.

Installation

Download the appropriate binary for your platform from the assets below, extract it, and add it to your PATH.

Changes

Changelog

Bug fixes

  • 3322df3 fix(deps): bump golang.org/x/crypto in /jsonschema/oas3/tests (#82)
  • b5e725e fix(deps): bump the go-minor-patch group across 2 directories with 3 updates (#77)
  • 1cb10f3 fix: handle chained header references in bundle command (#83)

Others

  • 4b37d09 build: upgrade CLI to 1cb10f3
  • 8798147 ci(deps): bump the github-actions group across 1 directory with 2 updates (#80)

Full Changelog: v1.11.1...v1.11.2

Released by GoReleaser.

v1.11.1

26 Nov 08:23
6efa364

Choose a tag to compare

OpenAPI CLI v1.11.1

This release includes binaries for Linux, macOS, and Windows on both x86_64 and ARM64 architectures.

Installation

Download the appropriate binary for your platform from the assets below, extract it, and add it to your PATH.

Changes

Changelog

Bug fixes

  • ee23a08 fix: correct array sync to preserve identity matching during subset operations

Others

  • 6efa364 Merge pull request #78 from speakeasy-api/subomi/fix/fix-syncing-array
  • 991c710 refactor: clean up array subset sync test

Full Changelog: v1.11.0...v1.11.1

Released by GoReleaser.

v1.11.0

17 Oct 05:21
4215825

Choose a tag to compare

What's New

Swagger 2.0 Support

This release adds comprehensive support for Swagger 2.0 specifications including full parsing, validation, walking, and an upgrade utility to convert to OpenAPI 3.0.

Core Features:

  • Complete Swagger 2.0 data models with marshalling support
  • Full validation against Swagger 2.0 specification
  • Walking API to traverse Swagger documents with the same pattern as OpenAPI
  • Comprehensive test coverage with 227 tests including round-trip testing with real-world specs (Petstore, DocuSign, Docker Engine API)

Upgrade Utility

Automatic conversion from Swagger 2.0 to OpenAPI 3.0 with proper schema mapping:

  • swagger: "2.0"openapi: "3.0.0"
  • host/basePath/schemesservers
  • definitionscomponents.schemas
  • parameters (body) → components.requestBodies
  • securityDefinitionscomponents.securitySchemes
  • Request/response schema wrapping in content objects
  • Reference rewriting (#/definitions/#/components/schemas/)
  • 17 upgrade tests covering common and edge case scenarios

CLI Commands

  • openapi swagger upgrade - Convert Swagger 2.0 to OpenAPI 3.0
  • openapi swagger validate - Validate Swagger 2.0 documents

Additional Improvements

  • JSON marshalling: Fixed nul character handling to use proper JSON Unicode escapes (\u0000) instead of Go-style hex escapes (\x00)
  • Code quality: Resolved all linting issues (gocritic, staticcheck, unparam, gosec, nilaway)
  • Test improvements: All tests use t.Context() for better lifecycle management

Testing

  • ✅ All 227 swagger tests pass
  • ✅ All 513 total tests pass (including JSON Schema test suite)
  • ✅ Linting passes with 0 issues
  • ✅ Round-trip testing with real-world Swagger specs validates correctness

Breaking Changes

None - this is purely additive functionality.

Full Changelog: v1.10.1...v1.11.0

OpenAPI CLI v1.11.0

This release includes binaries for Linux, macOS, and Windows on both x86_64 and ARM64 architectures.

Installation

Download the appropriate binary for your platform from the assets below, extract it, and add it to your PATH.

Changes

Changelog

Features

  • 4215825 feat: add Swagger 2.0 support with upgrade to OpenAPI 3.0 utility (#66)

Full Changelog: v1.10.1...v1.11.0

Released by GoReleaser.

v1.10.1

16 Oct 06:38

Choose a tag to compare

Release Notes

Fixes

  • Snip TUI select-all/deselect bug
  • Clean reachability and tag cleanup
  • Documentation updates

Related Pull Request

OpenAPI CLI v1.10.1

This release includes binaries for Linux, macOS, and Windows on both x86_64 and ARM64 architectures.

Installation

Download the appropriate binary for your platform from the assets below, extract it, and add it to your PATH.

Changes

Changelog

Bug fixes

  • c22c17a fix: snip TUI select-all/deselect bug; clean reachability and tag cleanup; docs (#65)

Others

  • ed689a1 Create release notes for version based on PR #65

Full Changelog: v1.10.0...v1.10.1

Released by GoReleaser.