Skip to content
Ishvana Ishvana Docs

Get Routing Opportunities

GET
/api/agents/routing-opportunities

Discover available routing paths and agent availability.

Provides proactive visibility into available agents and their capacity for intelligent task distribution planning.

Returns: RoutingOpportunitiesResponse with available routing opportunities

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

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Successful Response

RoutingOpportunitiesResponse

Response model for routing opportunities discovery.

Returns available routing paths and agent availability for proactive task distribution.

Fields: status: Operation status opportunities: List of routing opportunities total_available: Total available capacity recommended_distribution: Suggested task distribution timestamp: When this snapshot was taken

Usage: GET /api/agents/routing/routing-opportunities

object
status
Status

Operation status

string
default: success
opportunities
required
Opportunities

Routing opportunities

Array<object>
RoutingOpportunityInfo

Individual routing opportunity information.

Fields: agent_id: Agent identifier available_capacity: Available task capacity specializations: Agent specializations recent_performance: Recent performance score recommended_tasks: Types of tasks this agent excels at

object
agentId
required
Agentid

Agent identifier

string
availableCapacity
required
Availablecapacity

Available capacity

integer
specializations
required
Specializations

Specializations

Array<string>
recentPerformance
Any of:
number
recommendedTasks
Any of:
Array<string>
totalAvailable
required
Totalavailable

Total available capacity

integer
recommendedDistribution
Any of:
object
key
additional properties
integer
timestamp
required
Timestamp

Snapshot timestamp

string