unique-path-item-parameter

Overview

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

The parameters list provided using the parameters property in the Path Item Object must not include any duplicate parameter definitions. A unique parameter is defined by a combination of its name and location.

Property	Value
Enabled	Yes
Maximum Severity	Error
Message	Duplicate entry found for parameter in the Path Item level parameters.
Code	OPENAPI3STANDARDS_V046
Type	Validation
Rule System	Semantic
Broad Category	Path Items
Products Impacted	API Transformer, Code Generation, Developer Experience Portal
Tags	openapi3 openapi standards semantic validation parameters parameter name location path

Suggested Fixes

• Remove duplicate entry of a parameter from the parameters list.
• If name and location of a parameter matches with that of some other parameter entry, remove one of such entries.
• Parameter names are compared in a case-sensitive manner.

For More Information

• https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#openapi-specification
• https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#path-item-object:~:text=be%20removed%20there.-,The%20list%20MUST%20NOT%20include%20duplicated%20parameters.%20A%20unique%20parameter%20is%20defined%20by%20a%20combination%20of%20a%20name%20and%20location,-.%20The%20list%20can
• https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#path-item-object:~:text=be%20removed%20there.-,The%20list%20MUST%20NOT%20include%20duplicated%20parameters.%20A%20unique%20parameter%20is%20defined%20by%20a%20combination%20of%20a%20name%20and%20location,-.%20The%20list%20can
• https://docs.apimatic.io/rulesets/overview/