Issues

• Property type change on referenced component schema is silently ignored

  bugOpenAP 3.1.0 Support
  OpenAPITools/openapi-diff#910 · Filter by author gorazdio opened on Jun 12, 2026
  1

• Changes reported in operations but only securityScheme changed

  Render capabilities
  OpenAPITools/openapi-diff#893 · Filter by author smjonas opened on Feb 25, 2026
  1

• [Bug] Backward compatibility check fails on reordered discriminator mappings

  Breaking/Non-Breaking classification
  OpenAPITools/openapi-diff#886 · Filter by author OllieKosh opened on Jan 30, 2026

• Feature Request: generate Overlay for the given 2 OpenAPI files

  Feature

  OpenAPITools/openapi-diff#883 · Filter by author pavelkornev opened on Jan 20, 2026

• Renderers should display example changes, not just schema changes

  Render capabilities
  OpenAPITools/openapi-diff#872 · Filter by author DrSatyr opened on Nov 28, 2025

• Operations are detected as changed when comparing for open api version 3.0.1 and 3.1.0

  OpenAP 3.1.0 Support
  Bug

  OpenAPITools/openapi-diff#858 · Filter by author hsav opened on Nov 7, 2025

• Operation description change is detected as a change but it is not rendered by HtmlRender

  Render capabilities
  Bug

  OpenAPITools/openapi-diff#857 · Filter by author hsav opened on Nov 7, 2025

• TeamCity renderer

  Render capabilities
  Feature

  OpenAPITools/openapi-diff#849 · Filter by author Vampire opened on Oct 14, 2025

• ExtensionDiff in renderers (just tried console and html)

  enhancementRender capabilities
  OpenAPITools/openapi-diff#839 · Filter by author Vampire opened on Sep 25, 2025
  1

• Mark down changelog generation - enum rename interpreted as added

  Bug

  OpenAPITools/openapi-diff#828 · Filter by author dawidwozny opened on Sep 11, 2025 · 2.2.0
  1

• IllegalArgumentException: "Invalid ref..." when uses an external link like "../demo#/components"

  OpenAPITools/openapi-diff#810 · Filter by author lovesickness-pika opened on Aug 11, 2025
  2

• Bug: erroneous detection of changes with mediaTypes, failure to generate html/markdown reports

  Bug

  OpenAPITools/openapi-diff#805 · Filter by author abeathamebi opened on Aug 7, 2025 · 2.2.0
  1

• Bug: no details when securitySchemes.*.name changes

  OpenAP 3.1.0 Support
  Bug

  OpenAPITools/openapi-diff#802 · Filter by author Samuel-StO opened on Jul 17, 2025 · 2.2.0

• Changing response field type from oneOf: string, number to string shouldn't break

  Breaking/Non-Breaking classification
  Bug

  OpenAPITools/openapi-diff#798 · Filter by author nesk opened on Jul 4, 2025
  4

• Changing request field type from string to oneOf: string, number shouldn't break

  Breaking/Non-Breaking classification
  Bug

  OpenAPITools/openapi-diff#797 · Filter by author nesk opened on Jul 4, 2025 · 2.2.0

• Support for detecting changes in webhooks

  OpenAP 3.1.0 Support
  Feature

  OpenAPITools/openapi-diff#793 · Filter by author caristu opened on Jun 17, 2025 · 2.2.0

• Exception in thread "main" java.lang.StackOverflowError

  bug
  OpenAPITools/openapi-diff#788 · Filter by author Andreik8s opened on May 26, 2025

• Unify Handling of allOf/anyOf and oneOf in Diff logic

  enhancement
  Feature

  OpenAPITools/openapi-diff#772 · Filter by author DrSatyr opened on Apr 22, 2025 · 2.2.0

• Markdown output does not specify whether the change is backward-compatible or not

  Breaking/Non-Breaking classificationRender capabilities
  OpenAPITools/openapi-diff#766 · Filter by author tuananhlai opened on Apr 5, 2025 · 2.2.0
  1

• Comparing OpenAPI 3.0.1 to 3.1.0 does not work

  OpenAP 3.1.0 Support
  Bug

  OpenAPITools/openapi-diff#755 · Filter by author codesimplicity opened on Mar 14, 2025 · 2.2.0
  5

• [OpenAPI 3.1.0 support] JsonSchema type changes not handled.

  OpenAP 3.1.0 Support
  Bug

  OpenAPITools/openapi-diff#745 · Filter by author DrSatyr opened on Feb 10, 2025 · 2.2.0

• Missing #/components/securitySchemes section leads to IllegalArgumentException

  good first issuehelp wanted
  Bug

  OpenAPITools/openapi-diff#737 · Filter by author DrSatyr opened on Jan 30, 2025

• Schema description update should be considered as a metadata change

  Breaking/Non-Breaking classificationduplicate
  Bug

  OpenAPITools/openapi-diff#694 · Filter by author stefk-fipto opened on Aug 13, 2024 · 2.2.0
  2

• Deleted or renamed properties are marked as backwards compatible

  Breaking/Non-Breaking classification
  Bug

  OpenAPITools/openapi-diff#673 · Filter by author Patrick-Bayer opened on Jun 14, 2024 · 2.2.0
  7

• Report totals

  enhancement
  Feature

  OpenAPITools/openapi-diff#627 · Filter by author dblock opened on Mar 5, 2024