Note that parameters is an array, so, in YAML, each parameter definition must be listed with a dash (-) in front of it. Parameter Types OpenAPI 3.0 distinguishes between the following parameter types based on the parameter location. The location is determined by the parameter’s in key, for example, in: query or in: path. path parameters, such as /users/{id} query parameters, such as /users?role=ad