Skip to content

Composite architecture-health check (circular + missing)

GET
/api/agents/architecture/validate/all

Run both graph-level validations and return them in a single response.

Saves dashboards a round-trip when the only question is “is the architecture healthy?”. is_valid is True only when both circular-dependency and missing-dependency validations pass.

Returns: ArchitectureValidationSummaryResponse with nested circular + missing sub-responses and the combined is_valid flag.

Successful Response

ArchitectureValidationSummaryResponse

Composite architecture-health check for dashboards and startup gating.

Bundles the circular-dependency and missing-dependency validations into a single round-trip so UIs can render an “is the graph valid?” indicator without two sequential requests. is_valid is True only when both sub-validations pass.

object
circularDependencies
required
CircularDependenciesResponse

Full circular-dependency validation result

object
hasCircularDependencies
required
Hascirculardependencies

Circular deps detected

boolean
isValid
required
Isvalid

Valid dependency graph

boolean
message
required
Message

Validation result message

string
missingDependencies
required
MissingDependenciesResponse

Full missing-dependency validation result

object
missingDependencies
required
Missingdependencies

Agent → missing deps map

object
key
additional properties
Array<string>
affectedAgents
required
Affectedagents

Agents with missing deps

Array<string>
isValid
required
Isvalid

All dependencies satisfied

boolean
totalMissing
required
Totalmissing

Total missing relationships

integer
isValid
required
Isvalid

True when both sub-validations pass

boolean