[Schema Inaccuracy] Lint OpenAPI files

[hfhbd]

Schema Inaccuracy

Instead of fixing the GitHub issues, you should lint the OpenAPI files first, eg using redocly:

docker run --rm -v $PWD:/spec ghcr.io/redocly/cli lint --extends=recommended-strict myApi.json

Expected

No lint errors

Reproduction Steps

docker run --rm -v $PWD:/spec ghcr.io/redocly/cli lint --extends=recommended-strict myApi.json

[dinonuggies1]

Thank you for opening this issue, @hfhbd.

We have an internal process for linting and validating our OpenAPI files, but schema inaccuracies can be challenging to catch when they diverge from the implementation. We're continually working to improve our process and appreciate your feedback. 🙏🏽