spec.refs.cycle-preserved
- Category
- API specification
- Default severity
- Warning
- Applies to
- API specification
- Default outcome
- Completed with warnings
- Recommended action
- Fix the source
- Grouped by
- Source location
Why it matters
Cyclic $refs are preserved rather than inlined, which can reduce type fidelity in generated artifacts.
How to fix it
- Break the $ref cycle by extracting a shared schema, if practical.