Skip to main content

path-no-duplicate-slash

Disallows // in a path template.

AttributeValue
CategoryOperations
MaturityGold
OpenAPISwagger 2.0; OpenAPI 3.0, 3.1, 3.2
StarterOff
Lenient–StrictWarning
CompleteError

Intent​

Duplicate separators create ambiguous URLs and can be normalized differently by clients, gateways, and servers.

Flags​

Any path key containing two consecutive forward slashes anywhere in the string.

Does not flag​

Paths with single separators. This rule does not check trailing slashes or path naming style.

See it fail​

paths:
/payments//items:
get:
responses:
'200':
description: OK

The diagnostic reports that /payments//items should not contain duplicate slashes.

Fix it​

paths:
/payments/items:
get:
responses:
'200':
description: OK

Configure​

profiles:
default:
rules:
extends: [recommended]
override:
path-no-duplicate-slash: error

Nearby: no-path-trailing-slash, paths-kebab-case.