Skip to content

Latest commit

 

History

History
37 lines (32 loc) · 905 Bytes

File metadata and controls

37 lines (32 loc) · 905 Bytes

path-param-required-field

This rule validates that all ParameterObjects specify optional parameter field explicitly.

Examples of valid OpenAPI ParameterObject

components:
    parameters:
        petId:
            name: petId
            in: path
            description: ID of pet that needs to be updated
            required: true # <-- valid
            schema:
                type: string
        petBreed:
            name: petBreed
            in: query
            description: Breed of pet that needs to be updated
            required: false # <-- valid
            schema:
                type: string

Examples of invalid OpenAPI SchemaObject

components:
    parameters:
        petId: # <-- invalid
            name: petId
            in: path
            description: ID of pet that needs to be updated
            schema:
                type: string