Fix duplicate codeExamples keys for multi-status-code REST responses (#60530)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: heiskr

src/rest/scripts/utils/create-rest-examples.ts

@@ -328,11 +328,11 @@ export function getResponseExamples(operation: Operation): ResponseExample[] {
       // This is a fallback to allow using the `example` property in
       // the schema. If we start to enforce using examples vs. example using
       // a linter, we can remove the check for `example`.
-      // For now, we'll use the key default, which is a common default
-      // example name in the OpenAPI schema.
+      // We key by statusCode so that operations with multiple success
+      // responses (e.g. 200 + 201) get unique keys instead of colliding.
       if (operation.responses[statusCode].content[contentType].example) {
         examples = {
-          default: {
+          [statusCode]: {
             value: operation.responses[statusCode].content[contentType].example,
           },
         }

src/rest/tests/create-rest-examples.ts

@@ -1,6 +1,9 @@
 import { describe, expect, test } from 'vitest'
 
-import getCodeSamples, { mergeExamples } from '../scripts/utils/create-rest-examples'
+import getCodeSamples, {
+  mergeExamples,
+  getResponseExamples,
+} from '../scripts/utils/create-rest-examples'
 import {
   operation,
   noContent,
@@ -63,4 +66,31 @@ describe('rest example requests and responses', () => {
       )
     }
   })
+
+  test('response examples have unique keys when multiple status codes use inline example', () => {
+    const multiStatusOp = {
+      responses: {
+        200: {
+          description: 'Response when already exists',
+          content: {
+            'application/json': {
+              example: { id: 1, status: 'existing' },
+            },
+          },
+        },
+        201: {
+          description: 'Response when created',
+          content: {
+            'application/json': {
+              example: { id: 1, status: 'created' },
+            },
+          },
+        },
+      },
+    }
+    const examples = getResponseExamples(multiStatusOp)
+    const keys = examples.map((e) => e.key)
+    expect(keys).toEqual(['200', '201'])
+    expect(new Set(keys).size).toBe(keys.length)
+  })
 })