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.