Merge pull request #4917 from karenetheridge/v3.1-example-examples-mutually-exclusive

v3.1: "example" and "examples" cannot appear together

Author: handrews

src/schemas/validation/schema.yaml

@@ -951,6 +951,10 @@ $defs:
         type: object
         additionalProperties:
           $ref: '#/$defs/example-or-reference'
+    not:
+      required:
+        - example
+        - examples
 
   map-of-strings:
     type: object

tests/schema/fail/example-examples.yaml

@@ -0,0 +1,20 @@
+openapi: 3.1.1
+
+# this example should fail, as example cannot be used together with examples.
+
+info:
+  title: API
+  version: 1.0.0
+components:
+  parameters:
+    animal:
+      name: animal
+      in: header
+      schema: {}
+      example: bear
+      examples:
+        a mammalian example:
+          value: bear
+
+
+