Skip to content

Get architecture statistics and metrics

GET
/api/agents/architecture/stats

Return per-type/category/priority distributions plus flag-count rollups.

Numbers are agent counts, not live telemetry — use the system monitoring endpoints for real CPU/memory/network percentages.

Successful Response

ArchitectureStatsResponse

Aggregate counts and per-flag breakdowns for the agent architecture.

object
totalAgents
required
Totalagents

Total agents in system

integer
typeDistribution
required
Typedistribution

Agents by type

object
key
additional properties
integer
categoryDistribution
required
Categorydistribution

Agents by category

object
key
additional properties
integer
priorityDistribution
required
Prioritydistribution

Agents by priority

object
key
additional properties
integer
systemImpact
required
ArchitectureSystemImpactInfo

Count-based impact metrics

object
autoStartAgents
required
Autostartagents

Agents that start on boot

integer
systemModifyingAgents
required
Systemmodifyingagents

Agents allowed to mutate system state

integer
userVisibleAgents
required
Uservisibleagents

Agents exposed in the UI

integer
cpuIntensiveAgents
required
Cpuintensiveagents

Agents flagged cpu_intensive

integer
memoryIntensiveAgents
required
Memoryintensiveagents

Agents flagged memory_intensive

integer
networkAccessAgents
required
Networkaccessagents

Agents requiring network

integer
detailedLists
required
Detailedlists

Agent names by capability

object
key
additional properties
Array<string>