I believe the issue is that /components/schemas needs to map to only one level of /keyword/Schema, and OpenAPI does not accept requestPayloads as an intervening hierarchical level. To be compliant, we need to remove requestPayloads and responsePayloads as an intermediate level; replacing the "/" with "-" would be the simplest fix.
This has significant ramifications downstream of course for anything that invokes those schema definitions.
960 of the 11398 errors are of type:
Error spec rule :: Property
create/update{...}
is not expected here.For example,
components/schemas/requestPayloads/updateSchoolInfo
:I believe the issue is that /components/schemas needs to map to only one level of /keyword/Schema, and OpenAPI does not accept requestPayloads as an intervening hierarchical level. To be compliant, we need to remove requestPayloads and responsePayloads as an intermediate level; replacing the "/" with "-" would be the simplest fix.
This has significant ramifications downstream of course for anything that invokes those schema definitions.