When running the openapi.json through the https://editor.swagger.io/ editor, it flags just over 150 errors in the published spec (attached as openapi_errors.txt).

Additionally, when I try to run the spec through a generator to create code for utilizing the REST API, a number of other errors are found (attached as openapi_generate_error.txt)

Having these issues resolved will make using the REST API much easier for users, as even with the current spec, there is a lot of trial and error that users must go through to understand how to format data and to figure out what data to expect back out.