added multiple response examples for openAPI

api-playground/openapi/advanced-features.mdx

@@ -7,7 +7,7 @@
 
 ## `oneOf`, `anyOf`, `allOf`
 
 For complex datatypes, OpenAPI provides the `oneOf`, `anyOf`, and `allOf` keywords, allowing you to combine schemas in certain ways. You can read more about these keywords in the [Swagger documentation](https://swagger.io/docs/specification/data-models/oneof-anyof-allof-not/), but essentially:
 
 - `oneOf` functions like an "exclusive-or" operator
 - `anyOf` functions like an "or" operator
@@ -54,7 +54,7 @@
 
 ### Providing options with `oneOf` and `anyOf`
 
 When you use `oneOf` or `anyOf`, Mintlify displays the options in a tabbed container. To give your options helpful names, make sure to give each subschema a `title` field. For example, here's how you might display two different types of delivery addresses:
 
 ```yaml
 delivery_address:
@@ -135,3 +135,32 @@
             const planter = require('planter');
             planter.list({ potted: true });
 ```
+
+## Multiple Response Examples
+
+If your API returns different responses based on the request, you can provide multiple examples.
+
+For example here's two different responses for a 200 response.
+
+```yaml [expandable]
+responses:
+        '200':
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/YourResponseSchema'
+              examples:
+                us:
+                  summary: Response for United States
+                  value:
+                    countryCode: "US"
+                    currencyCode: "USD"
+                    taxRate: 0.0825
+                gb:
+                  summary: Response for United Kingdom
+                  value:
+                    countryCode: "GB"
+                    currencyCode: "GBP"
+                    taxRate: 0.20
+```