Why required: [] generates an error

[erdnax123]

{
    ...
    "components": {
        "schemas": {
            "ABC": {
                "required": [],
                 ...
             },
             ...
        }
    }
}

this generates an error:

components -> schemas -> ABC -> required
  ensure this value has at least 1 items (type=value_error.list.min_items; limit_value=1)

"required": null do not generates an error

expected:

• required not set
• required = null
• required = []

are the same and not generates an error

[dbanty]

Sure sounds like a bug 🐛. Thanks for reporting!

[joaonc]

I don't think this is a bug. The parser in the IDE I use (JetBrains PyCharm) also spits out an error saying the required field needs at least one item.
If you don't have any required fields, don't add required.

This ticket can be closed, imo.

[benweint]

The OpenAPI spec section on the Schema object says:

The Schema Object allows the definition of input and output data types. These types can be objects, but also primitives and arrays. This object is a superset of the JSON Schema Specification Draft 2020-12.

For more information about the properties, see JSON Schema Core and JSON Schema Validation.

The JSON Schema Validation spec says of the required property:

The value of this keyword MUST be an array. Elements of this array, if any, MUST be strings, and MUST be unique.

An object instance is valid against this keyword if every item in the array is the name of a property in the instance.

Omitting this keyword has the same behavior as an empty array.

... which makes pretty clear that specifying an empty array for required is supported by JSON Schema, and thus by OpenAPI, and thus should be supported by this tool's model of OpenAPI.