Skip to main content

spec-querystring-parameters

Allows at most one in: querystring parameter per effective parameter set and forbids mixing it with in: query.

AttributeValue
CategoryParameters
MaturityBaseline
OpenAPIOpenAPI 3.2 only
Starter–CompleteError

See it fail

parameters:
- in: querystring
name: filter
schema: { type: string }
- in: query
name: status
schema: { type: string }

Fix it

Model the query string with one strategy: one querystring parameter or individual query parameters.

Path-level and operation-level parameters are evaluated together for each operation.

Nearby: query-param-collision, operation-parameters-unique.