Skip to main content

only-one-body-parameter-in-path-item-parameters

Overview

This rule belongs to the swagger-v2-standards-validation ruleset and states that:

The parameters list provided using the 'parameters' property in the Path Item Object must not include more than one 'body' parameter definitions. If multiple body parameters are found, their location will be automatically updated to formData during import/transformations in APIMatic.

PropertyValue
EnabledYes
Maximum SeverityError
MessageMore than one 'body' parameter found in path item parameters list.
CodeSWAGGER20STANDARDS_V052
TypeValidation
Rule SystemSemantic
Broad CategoryPath Items
Products ImpactedAPI Transformer, Code Generation, Developer Experience Portal
Tagsswagger2 swagger standards semantic validation parameters parameter body path type

Suggested Fixes

  • Remove additional 'body' parameters from the parameters list.
  • Parameter types are compared in a case-sensitive manner.

For More Information