From dc5dad66bf9b393931e0e4677cba9579b5df9a28 Mon Sep 17 00:00:00 2001
From: Karen Etheridge <ether@cpan.org>
Date: Sun, 31 Aug 2025 16:07:00 -0700
Subject: [PATCH] "example" and "examples" cannot appear together

This affects the places where examples are used: parameter, header, and media-type objects

for #4598.
---
 src/schemas/validation/schema.yaml      |  4 ++++
 tests/schema/fail/example-examples.yaml | 20 ++++++++++++++++++++
 2 files changed, 24 insertions(+)
 create mode 100644 tests/schema/fail/example-examples.yaml

diff --git a/src/schemas/validation/schema.yaml b/src/schemas/validation/schema.yaml
index e658ceb745..0717e2632f 100644
--- a/src/schemas/validation/schema.yaml
+++ b/src/schemas/validation/schema.yaml
@@ -1089,6 +1089,10 @@ $defs:
         type: object
         additionalProperties:
           $ref: '#/$defs/example-or-reference'
+    not:
+      required:
+        - example
+        - examples
 
   map-of-strings:
     type: object
diff --git a/tests/schema/fail/example-examples.yaml b/tests/schema/fail/example-examples.yaml
new file mode 100644
index 0000000000..eb91f13338
--- /dev/null
+++ b/tests/schema/fail/example-examples.yaml
@@ -0,0 +1,20 @@
+openapi: 3.2.0
+
+# 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:
+          dataValue: bear
+
+
+