Optional
allowOptional
allowDetermines whether the parameter value SHOULD allow reserved characters,
as defined by
[RFC3986]
:/?#[]@!$&'()*+,;=
to be included without percent-encoding. This property
only applies to parameters with an in
value of query
. The default value
is false
.
Optional
contentA map containing the representations for the parameter. The key is the media type and the value describes it. The map MUST only contain one entry.
Optional
deprecatedSpecifies that a parameter is deprecated and SHOULD be transitioned out
of usage. Default value is false
.
Optional
descriptionA brief description of the parameter. This could contain examples of use. CommonMark syntax MAY be used for rich text representation.
Optional
exampleExample of the parameter’s potential value. The example SHOULD match the
specified schema and encoding properties if present. The example
field is
mutually exclusive of the examples
field. Furthermore, if referencing a
schema
that contains an example, the example
value SHALL override
the example provided by the schema. To represent examples of media types
that cannot naturally be represented in JSON or YAML, a string value can
contain the example with escaping where necessary.
Optional
examplesExamples of the parameter’s potential value. Each example SHOULD contain
a value in the correct format as specified in the parameter encoding. The
examples
field is mutually exclusive of the example
field. Furthermore,
if referencing a schema
that contains an example, the examples
value
SHALL override the example provided by the schema.
Optional
explodeWhen this is true, parameter values of type array
or object
generate
separate parameters for each value of the array or key-value pair of the
map. For other types of parameters this property has no effect. When
style
is
form
, the default value is true
. For all other styles, the default
value is false
.
Optional
requiredDetermines whether this parameter is mandatory. If the parameter
location is
"path"
, this property is REQUIRED and its value MUST be true
.
Otherwise, the property MAY be included and its default value is false
.
Optional
schemaThe schema defining the type used for the parameter.
Optional
style
See
https://spec.openapis.org/oas/latest.html#header-object