Skip to main content



This rule belongs to the openapi-v3-apimatic-linting ruleset and states that:

In OpenAPI specifications, when using XML for the parameter schema, it is required to specify the XML name. However, for array non-wrapped cases, the name does not need to be directly specified in the schema XML. In such cases, it will be present in the inner items schema.

Maximum SeverityError
MessageXML name is required for parameter schema.
Rule SystemSemantic
Broad CategoryOpenAPI XML
Products ImpactedAPI Transformer, Code Generation, Developer Experience Portal
Tagsopenapi3 openapi apimatic semantic linting parameter schema xml name

Suggested Fixes

  • Check the OpenAPI specification to confirm if any parameter schema is missing an XML name.
  • If any parameter schema is missing an XML name, update the specification to include an XML name for the parameter schema.

For More Information