Skip to main content



This rule belongs to the openapi-v3-standards-validation ruleset and states that:

HTTP methods like GET, DELETE, HEAD are not allowed to have a request body since a payload for these methods do not have any defined semantics. If request body is defined for non-body HTTP verbs, it will get ignored. Therefore, in OpenAPI as well, the DELETE Operation Object must not set the requestBody property.

Maximum SeverityWarning
MessageOperation Object for DELETE HTTP method cannot have a request body.
Rule SystemSemantic
Broad CategoryOperations
Products ImpactedAPI Transformer, Code Generation, Developer Experience Portal
Tagsopenapi3 openapi standards semantic validation delete request body body parameter operation

Suggested Fixes

  • Remove the requestBody property from the DELETE Operation Object.
  • Change the HTTP method to POST or any other method that supports request body.

For More Information