An OpenAPI Overlay is a separate document whose ordered actions select and update, remove, or copy nodes of a target description. It can enrich team documentation, tags, or environment details while leaving the source unchanged. Each action applies after the preceding action.
The demo toggles an overlay that adds an audience tag and description to GET /orders. Validate the transformed result and keep ownership of source and overlay clear.
When to use
Use it when a shared or externally supplied specification needs local documentation additions.