Azure/openapi-diff

View on GitHub

Command line tool to detect breaking changes between two openapi specifications

Stars: 290
Forks: 50
Open beginner issues: 0
Indexed issues: 84
Avg merge: 2d 21h
Merged PRs (30d): 10

Dominant language: C#
License: MIT
Last GitHub push: Sep 18, 2026
Latest indexed: Sep 14, 2026
Contributing guide: Contributing guide
Code of conduct: Code of conduct
Beginner labels: No beginner labels indexed

Beginner friendly Everything

Open All

Crash if inherited property is structurally equal but not reference identical Open

Azure/openapi-diff#482 · 1 assignee · Opened May 5, 2026
Crash if duplicate model names (across files) used in allOf Open

Azure/openapi-diff#479 · 2 comments · 1 assignee · Opened May 5, 2026
Remove dependency `autorest` Open

Azure/openapi-diff#456 · 1 assignee · Opened Mar 3, 2026
Error: Invalid reference token: /Tables(\'{tableName}\') Open

Difficulty 4/5 3-5 days Newbie friendliness 35/100

Azure/openapi-diff#445 · Opened Jan 27, 2026
OpenAPI-diff should flag changes in the tags for an operation Open

Azure/openapi-diff#371 · 7 comments · 1 assignee · Opened Sep 1, 2025
False positive: 'RemovedRequiredParameter' rule flagged incorrectly Open

Difficulty 4/5 3-5 days Newbie friendliness 25/100

Azure/openapi-diff#364 · 4 comments · Opened Aug 20, 2025
Improve the error reported in the log for a NullReferenceException issue Open

Difficulty 3/5 1-2 days Newbie friendliness 35/100

Azure/openapi-diff#362 · 2 comments · Opened Aug 6, 2025
Migrate OpenApiDiff app to the newest version of dotnet Open

Difficulty 3/5 1-2 days Newbie friendliness 35/100

Azure/openapi-diff#357 · Opened Jun 16, 2025
we should report breaking change for x-ms-discriminator-value change Open

Difficulty 4/5 3-5 days Newbie friendliness 35/100

Azure/openapi-diff#350 · Opened Feb 11, 2025
Removing `readOnly: true` on response-only property is flagged as error Open

Difficulty 4/5 3-5 days Newbie friendliness 35/100

Azure/openapi-diff#349 · Opened Jan 16, 2025
Docs on the CLI or the JS API? Open

Difficulty 5/5 Over a week Newbie friendliness 25/100

Azure/openapi-diff#348 · 3 reactions · Opened Dec 10, 2024
ExpandAllOf() throws "incompatible properties" if schemas are compatible but not equal Open

Azure/openapi-diff#347 · 5 comments · 1 assignee · Opened Dec 2, 2024
[CrossVersionBreakingChange] Paths for one error in a spec are empty Open

Azure/openapi-diff#346 · 1 assignee · Opened Oct 23, 2024
Test all specs in azure-rest-api-specs/main Open

Azure/openapi-diff#318 · 1 assignee · Opened Apr 3, 2024
[Bug] Comparison of additionalProperties should be fixed Open

Azure/openapi-diff#314 · 4 comments · 1 reaction · 1 assignee · Opened Mar 28, 2024
Move dependency from openapi-alps to azure-rest-api-specs Open

Azure/openapi-diff#309 · 3 comments · 1 reaction · 1 assignee · Opened Mar 23, 2024
Maintainability Roadmap Open

Azure/openapi-diff#308 · 2 comments · 2 reactions · 1 assignee · Opened Mar 21, 2024
False positivizes and undetailed errors for RequiredStatusChange Open

Difficulty 4/5 3-5 days Newbie friendliness 30/100

Azure/openapi-diff#288 · Opened Nov 17, 2023
api-version should not cause a ChangedParameterOrder error Open

Difficulty 3/5 1-2 days Newbie friendliness 45/100

Azure/openapi-diff#287 · 1 comment · Opened Nov 17, 2023
False positives when readOnly property using referenced enum Open

Difficulty 4/5 3-5 days Newbie friendliness 42/100

Azure/openapi-diff#286 · 1 comment · Opened Nov 17, 2023
missing docs for rule 1047 XmsEnumChanged Open

Difficulty 2/5 1-3 hours Newbie friendliness 45/100

Azure/openapi-diff#282 · Opened Nov 13, 2023
--help missing Open

Difficulty 3/5 1-2 days Newbie friendliness 42/100

Azure/openapi-diff#281 · Opened Nov 13, 2023
False positives for rule 1007 RemovedClientParameter when using typespec-autorest Open

Difficulty 4/5 3-5 days Newbie friendliness 28/100

Azure/openapi-diff#280 · 3 comments · Opened Nov 2, 2023
Allowing circular references Open

Difficulty 5/5 Over a week Newbie friendliness 25/100

Azure/openapi-diff#274 · 5 comments · 5 reactions · Opened Jul 7, 2023
oad runtime exception caused by retry-after header with integer value Open

Difficulty 3/5 1-2 days Newbie friendliness 45/100

Azure/openapi-diff#271 · Opened Feb 8, 2023
Add default response is not breaking change Open

Difficulty 3/5 1-2 days Newbie friendliness 20/100

Azure/openapi-diff#270 · Opened Feb 6, 2023
reorder api-version parameter is not breaking change Open

Difficulty 3/5 1-2 days Newbie friendliness 20/100

Azure/openapi-diff#269 · Opened Feb 6, 2023
the change of string format to `arm-id` from empty should not be a breaking change Open

Azure/openapi-diff#268 · 3 comments · 1 assignee · Opened Jan 31, 2023
Error: Unable to find a valid AutoRest core package Open

Difficulty 3/5 1-2 days Newbie friendliness 25/100

Azure/openapi-diff#262 · 1 comment · Opened Dec 21, 2022
failed with 'additionalProperties:true' Open

Azure/openapi-diff#260 · 1 assignee · Opened Dec 12, 2022
Runtime Exception - JSON integer is too large or small for an Int64 Open

bug

Difficulty 3/5 1-2 days Newbie friendliness 35/100

Azure/openapi-diff#258 · 1 comment · Opened Nov 25, 2022
autorest produce conflicts when merging swagger Open

bug

Difficulty 4/5 3-5 days Newbie friendliness 35/100

Azure/openapi-diff#253 · Opened Nov 7, 2022
[Rule] breaking changes, when x-ms-discriminator-value changes Open

Rule

Difficulty 4/5 3-5 days Newbie friendliness 35/100

Azure/openapi-diff#241 · 2 comments · Opened Sep 5, 2022
Is it possible to add custom rules? Open

question

Difficulty 5/5 Over a week Newbie friendliness 25/100

Azure/openapi-diff#240 · 5 comments · Opened Aug 30, 2022
Runtime Error - something to do with Autorest Open

Difficulty 3/5 1-2 days Newbie friendliness 25/100

Azure/openapi-diff#239 · 1 comment · 1 reaction · Opened Aug 19, 2022
Error contains no link to Problem line in Swagger Open

Difficulty 3/5 1-2 days Newbie friendliness 35/100

Azure/openapi-diff#238 · 2 comments · Opened Aug 15, 2022
improve the perf Open

Difficulty 5/5 Over a week Newbie friendliness 25/100

Azure/openapi-diff#227 · 1 reaction · Opened May 25, 2022
Support xs-ms-enum values without the "value" label Open

Difficulty 3/5 1-2 days Newbie friendliness 35/100

Azure/openapi-diff#216 · 2 comments · Opened Nov 29, 2021
Need detailed documentation Open

Difficulty 2/5 1-3 hours Newbie friendliness 35/100

Azure/openapi-diff#211 · 1 comment · Opened Jul 28, 2021
No difference reported for required property changed to optional Open

bug

Difficulty 3/5 1-2 days Newbie friendliness 42/100

Azure/openapi-diff#207 · 1 comment · Opened Jul 11, 2021
The example is empty in https://github.com/Azure/openapi-diff/blob/master/docs/rules/1031.md Open

Difficulty 1/5 Under an hour Newbie friendliness 50/100

Azure/openapi-diff#179 · Opened Nov 6, 2020
Wrong example about the https://github.com/Azure/openapi-diff/blob/master/docs/rules/1029.md Open

Difficulty 1/5 Under an hour Newbie friendliness 45/100

Azure/openapi-diff#178 · Opened Nov 6, 2020
Breaking change false positive when changing readonly property from true to false... Open

Difficulty 4/5 3-5 days Newbie friendliness 35/100

Azure/openapi-diff#172 · 1 reaction · Opened Jul 7, 2020
Publish OpenApiDiff to Nuget (or make dotnet cli tool) Open

Difficulty 5/5 Over a week Newbie friendliness 32/100

Azure/openapi-diff#151 · 2 comments · 11 reactions · Opened Jul 22, 2019
open api version 3 support Open

Difficulty 5/5 Over a week Newbie friendliness 25/100

Azure/openapi-diff#148 · 18 comments · 46 reactions · Opened May 15, 2019
TypeError issue reported by OAD in CI for azure-rest-api-specs repo Open

Difficulty 3/5 1-2 days Newbie friendliness 25/100

Azure/openapi-diff#134 · 1 comment · Opened Mar 30, 2019
Report application of "x-ms-client-name" for existing properties as breaking Open

Difficulty 3/5 1-2 days Newbie friendliness 25/100

Azure/openapi-diff#120 · 1 comment · Opened Jan 2, 2019
Error message "FATAL: Input parameter is required." Open

Difficulty 4/5 3-5 days Newbie friendliness 25/100

Azure/openapi-diff#119 · Opened Nov 14, 2018
JsonSerializationException on breaking changes pass Open

Difficulty 3/5 1-2 days Newbie friendliness 38/100

Azure/openapi-diff#118 · 2 comments · Opened Oct 1, 2018
Reporting at the REST endpoint level Open

Difficulty 5/5 Over a week Newbie friendliness 25/100

Azure/openapi-diff#102 · Opened Sep 27, 2017

Azure/openapi-diff

Get new issues in your inbox