Yashvardhan Thanvi (Thanatos9404) · Oct 16, 2026
diff --git a/.chronus/changes/fix-openapi3-sse-examples-3-2-2026-9-16-7-44-54.md b/.chronus/changes/fix-openapi3-sse-examples-3-2-2026-9-16-7-44-54.md
@@ -0,0 +1,7 @@
+---
+changeKind: fix
+packages:
+  - "@typespec/openapi3"
+---
+
+Emit `@opExample` response examples next to `itemSchema` for SSE streams in OpenAPI 3.2.0. They were silently dropped.
@@ -1255,6 +1255,8 @@ function createOAPIEmitter(
       return { schema: getRawBinarySchema(contentType) } as OpenAPI3MediaType;
     }
 
+    const oai3Examples = examples && getExampleOrExamples(program, examples);
+
     // Check if this is a stream response (only for responses)
     if (sseModule && isResponseContent) {
       // Use getStreamMetadata to check if this is a stream response
@@ -1278,13 +1280,12 @@ function createOAPIEmitter(
             (type: Type) => callSchemaEmitter(type, visibility, false, "application/json"),
           );
           if (Object.keys(mediaType).length > 0) {
-            return mediaType;
+            return { ...mediaType, ...oai3Examples };
           }
         }
       }
     }
 
-    const oai3Examples = examples && getExampleOrExamples(program, examples);
     switch (body.bodyKind) {
       case "single":
         return {

@@ -271,6 +271,59 @@ describe("openapi3: SSE (Server-Sent Events)", () => {
     });
   });
 
+  describe("SSE stream with response examples", () => {
+    const code = `
+      model Message {
+        type: "message";
+        text: string;
+      }
+
+      @events
+      union MessageEvents {
+        Message,
+      }
+
+      @route("/stream")
+      @get op stream(): SSEStream<MessageEvents>;
+
+      @@opExample(stream,
+        #{
+          returnType: #{
+            contentType: "text/event-stream",
+            body: "data: {\\"type\\":\\"message\\",\\"text\\":\\"hello\\"}\\n\\n",
+          },
+        },
+        #{ title: "Example stream" }
+      );
+    `;
+    const expectedExamples = {
+      "Example stream": {
+        summary: "Example stream",
+        value: 'data: {"type":"message","text":"hello"}\n\n',
+      },
+    };
+
+    it("emits examples next to itemSchema for OpenAPI 3.2.0", async () => {
+      const openApi = await openApiFor(code);
+      const eventStreamContent =
+        openApi.paths["/stream"].get.responses["200"].content["text/event-stream"];
+      ok(eventStreamContent.itemSchema, "expected itemSchema for SSE");
+      deepStrictEqual(eventStreamContent.examples, expectedExamples);
+    });
+
+    it.each(["3.0.0", "3.1.0"])("emits examples next to schema for OpenAPI %s", async (version) => {
+      const { openApi, diagnostics } = await openApiWithDiagnosticsFor(code, version);
+      expectDiagnostics(diagnostics, [
+        { code: "@typespec/openapi3/streams-not-supported", severity: "warning" },
+      ]);
+      const eventStreamContent = (openApi.paths["/stream"].get as any).responses["200"].content[
+        "text/event-stream"
+      ];
+      deepStrictEqual(eventStreamContent.schema, { type: "string" });
+      deepStrictEqual(eventStreamContent.examples, expectedExamples);
+    });
+  });
+
   const versionsWithNoItemSchema = ["3.0.0", "3.1.0"];
 
   versionsWithNoItemSchema.forEach((version) => {