Dynamic References

Dynamic referencing is a feature of JSON Schema draft 2020-12, and therefore included in OAS 3.1. It allows setting a placeholder reference target that can be overridden during validation depending on how the dynamic reference was reached. If that explanation didn’t help you at all, don’t worry, it boils down to two use cases:

While there may be other creative ways to use dynamic references, these are the situations most likely to show up in API descriptions.