Circular references

Updated: October 30, 2025

Description

Severity: Info

Circular references occur when two or more schema definitions reference each other in a way that creates a loop.

This rule applies at the API Specification level (OAS/Swagger).

Remediation

Find and remove the circular reference in the schema. Design schemas to avoid circular references from the start.

This error can also be caused by missing or unresolvable references.