Skip to content

Validate circular dependencies in architecture

GET
/api/agents/architecture/validate/circular-dependencies

Validate the entire agent dependency graph for circular references.

Traverses every agent’s dependency chain to detect cycles. A circular dependency means the startup sequencer cannot produce a valid ordering.

Returns: CircularDependenciesResponse with has_circular_dependencies, is_valid, and a message.

Successful Response

CircularDependenciesResponse

Result of validating the entire dependency graph for cycles.

A circular dependency means the startup sequencer cannot produce a valid topological ordering. is_valid is the inverse of has_circular_dependencies.

object
hasCircularDependencies
required
Hascirculardependencies

Circular deps detected

boolean
isValid
required
Isvalid

Valid dependency graph

boolean
message
required
Message

Validation result message

string