Skip to main content



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

Property allowReserved is only valid for query parameters (i.e. parameter location is set to query) and helps determine whether the parameter value should allow reserved characters. This property cannot be used with any other types of parameters e.g. path, header, or cookie.

Maximum SeverityWarning
MessageProperty allowReserved is used for a non-query parameter.
Rule SystemSemantic
Broad CategoryParameters
Products ImpactedAPI Transformer, Code Generation, Developer Experience Portal
Tagsopenapi3 openapi standards semantic linting reserved characters query parameter

Suggested Fixes

  • Remove property allowReserved from the current Parameter Object.
  • Change the parameter location to query if you want to allow sending it with reserved characters.

For More Information