Fix validity issues in openapi/swagger spec files (#1171)