Skip to content

Conversation

@sserrata
Copy link
Member

Adds support for the OpenAPI 3.1 schema.examples array in the API Explorer Body component. This is different from Media Type examples (which is an object with named examples) - schema.examples is an array of example values as per JSON Schema alignment in OAS 3.1.

  • Handle schema.examples for JSON content types
  • Handle schema.examples for XML content types
  • Add test cases for schema.examples

Closes #1164 (alternative implementation)

Description

Motivation and Context

How Has This Been Tested?

Screenshots (if appropriate)

Types of changes

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to change)

Checklist

  • I have updated the documentation accordingly.
  • I have read the CONTRIBUTING document.
  • I have added tests to cover my changes if appropriate.
  • All new and existing tests passed.

Adds support for the OpenAPI 3.1 schema.examples array in the API Explorer
Body component. This is different from Media Type examples (which is an
object with named examples) - schema.examples is an array of example values
as per JSON Schema alignment in OAS 3.1.

- Handle schema.examples for JSON content types
- Handle schema.examples for XML content types
- Add test cases for schema.examples

Closes #1164 (alternative implementation)
@sserrata sserrata self-assigned this Dec 19, 2025
@sserrata sserrata added the enhancement New feature or request label Dec 19, 2025
@github-actions
Copy link

Size Change: +4.12 kB (+0.19%)

Total Size: 2.15 MB

Filename Size Change
demo/.docusaurus/globalData.json 56.8 kB +571 B (+1.01%)
demo/.docusaurus/registry.js 82.4 kB +816 B (+1%)
demo/.docusaurus/routes.js 78 kB +769 B (+1%)
demo/.docusaurus/routesChunkNames.json 32.2 kB +326 B (+1.02%)
demo/build/assets/js/main.********.js 716 kB +1.49 kB (+0.21%)
demo/build/assets/js/runtime~main.********.js 20.2 kB +148 B (+0.74%)
ℹ️ View Unchanged
Filename Size
demo/.docusaurus/codeTranslations.json 2 B
demo/.docusaurus/docusaurus.config.mjs 14.6 kB
demo/.docusaurus/i18n.json 267 B
demo/.docusaurus/site-metadata.json 1.51 kB
demo/build/assets/css/styles.********.css 145 kB
demo/build/index.html 91.3 kB
demo/build/petstore/add-pet/index.html 27.8 kB
demo/build/petstore/create-user/index.html 22.5 kB
demo/build/petstore/create-users-with-array-input/index.html 22.6 kB
demo/build/petstore/create-users-with-list-input/index.html 22.6 kB
demo/build/petstore/delete-order/index.html 22.5 kB
demo/build/petstore/delete-pet/index.html 22.6 kB
demo/build/petstore/delete-user/index.html 22.8 kB
demo/build/petstore/find-pets-by-status/index.html 23.2 kB
demo/build/petstore/find-pets-by-tags/index.html 23.9 kB
demo/build/petstore/get-inventory/index.html 21.8 kB
demo/build/petstore/get-order-by-id/index.html 22.8 kB
demo/build/petstore/get-pet-by-id/index.html 23.3 kB
demo/build/petstore/get-user-by-name/index.html 22.9 kB
demo/build/petstore/login-user/index.html 23.4 kB
demo/build/petstore/logout-user/index.html 22.2 kB
demo/build/petstore/new-pet/index.html 22.7 kB
demo/build/petstore/pet/index.html 21 kB
demo/build/petstore/place-order/index.html 22 kB
demo/build/petstore/schemas/apiresponse/index.html 23.3 kB
demo/build/petstore/schemas/cat/index.html 37.2 kB
demo/build/petstore/schemas/category/index.html 24.3 kB
demo/build/petstore/schemas/dog/index.html 37.6 kB
demo/build/petstore/schemas/honeybee/index.html 37.7 kB
demo/build/petstore/schemas/id/index.html 21.4 kB
demo/build/petstore/schemas/order/index.html 25.5 kB
demo/build/petstore/schemas/pet/index.html 37.1 kB
demo/build/petstore/schemas/tag/index.html 22.7 kB
demo/build/petstore/schemas/user/index.html 44.8 kB
demo/build/petstore/store/index.html 20.2 kB
demo/build/petstore/subscribe-to-the-store-events/index.html 28.8 kB
demo/build/petstore/swagger-petstore-yaml/index.html 29 kB
demo/build/petstore/update-pet-with-form/index.html 22.7 kB
demo/build/petstore/update-pet/index.html 23.1 kB
demo/build/petstore/update-user/index.html 22.8 kB
demo/build/petstore/upload-file/index.html 22.6 kB
demo/build/petstore/user/index.html 20.7 kB

compressed-size-action

@github-actions
Copy link

Visit the preview URL for this PR (updated for commit 1518d11):

https://docusaurus-openapi-36b86--pr1269-qosf30kd.web.app

(expires Sun, 18 Jan 2026 20:22:37 GMT)

🔥 via Firebase Hosting GitHub Action 🌎

Sign: bf293780ee827f578864d92193b8c2866acd459f

@sserrata sserrata merged commit 09ac11f into main Dec 19, 2025
10 checks passed
@sserrata sserrata deleted the feat/schema-examples-support branch December 19, 2025 20:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants