Skip to content
Ishvana Ishvana Docs

Get Load Balancing Status

GET
/api/agents/load-balancing/status

Get current load distribution across all agents.

Provides real-time visibility into agent utilization for capacity planning and routing optimization decisions.

Returns: LoadBalancingStatusResponse with agent load information and recommendations

Raises: HTTPException 503: If communication hub is not available HTTPException 500: For unexpected errors

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Successful Response

LoadBalancingStatusResponse

Response model for load balancing status endpoint.

Provides current load distribution across all agents for capacity planning and routing optimization.

Fields: status: Operation status agents: List of agent load information total_agents: Total number of agents available_agents: Number of available agents system_utilization: Overall system utilization recommendations: Load balancing recommendations

Usage: GET /api/agents/routing/load-balancing/status

object
status
Status

Operation status

string
default: success
agents
required
Agents

Agent load info

Array<object>
AgentLoadInfo

Individual agent load information for load balancing.

Fields: agent_id: Agent identifier current_tasks: Number of active tasks capacity: Maximum task capacity utilization: Utilization percentage (0.0-1.0) availability: Whether agent is available specializations: Agent’s specializations

object
agentId
required
Agentid

Agent identifier

string
currentTasks
Currenttasks

Active task count

integer
0
capacity
Capacity

Maximum capacity

integer
default: 10
utilization
Utilization

Utilization rate

number
0
availability
Availability

Is available

boolean
default: true
specializations
Any of:
Array<string>
totalAgents
required
Totalagents

Total agent count

integer
availableAgents
required
Availableagents

Available count

integer
systemUtilization
required
Systemutilization

System utilization

number
recommendations
Any of:
Array<string>