Skip to content
Ishvana Ishvana Docs

Get Available Agents

GET
/api/agents/available

Retrieve the agent roster with real liveness status.

Returns the static analysis agent registry. status is sourced from agent_activity_service.get_all_agent_overviews() — "available" when the agent’s runtime handle reports awake, "offline" when asleep or unseen. Dynamic agent creation is not implemented, so dynamic_count is always 0.

Returns:

  • status: "success"
  • agents: List of agents; each entry carries:
    • name: registry name (lowercase)
    • type: "static" (all current agents) or "dynamic"
    • model: model label ("etherforce_managed" or "service_managed")
    • status: liveness from the activity service. AgentCapabilityInfo.status is Literal["available", "busy", "offline"]; this endpoint currently emits "available" (awake) or "offline" (asleep/unseen) — "busy" is reserved for future use.
    • capabilities: declared capability strings
  • total: Total agent count
  • static_count: Same as total (all agents are static today)
  • dynamic_count: Always 0

Raises:

  • Unhandled exceptions surface as HTTP 500 via FastAPI’s default handler. This endpoint does not touch the backend service, so there is no structured 503 path.

Example Response:

{
  "status": "success",
  "agents": [
    {
      "name": "hawken",
      "type": "static",
      "model": "etherforce_managed",
      "status": "available",
      "capabilities": ["creative_writing", "prose_generation"]
    }
  ],
  "total": 11,
  "staticCount": 11,
  "dynamicCount": 0
}

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Successful Response

AvailableAgentsResponse

Available agents roster response with static and dynamic agent classifications.

Returns comprehensive roster of all available agents including both static (configured) and dynamic (runtime-created) agents with capabilities, models, and availability status. Provides agent type breakdown for capacity planning.

Fields: status: Operation status indicator agents: List of agent information dictionaries total: Total number of available agents static_count: Number of statically configured agents dynamic_count: Number of dynamically created agents

Used By: - GET /api/agents/management/available endpoint - Agent discovery and task routing - System capacity planning

object
status
required
Status

Operation status: ‘success’ or error state

string
agents
required
Agents

List of agent information with name, type, model, status, capabilities

Array<object>
AgentCapabilityInfo

Agent capability roster entry.

object
name
required
Name
string
type
required
Type
string
Allowed values: static dynamic
model
required
Model
string
status
required
Status
string
Allowed values: available busy offline
capabilities
Capabilities
Array<string>
total
required
Total

Total number of available agents (static + dynamic)

integer
staticCount
required
Staticcount

Number of statically configured agents

integer
dynamicCount
required
Dynamiccount

Number of dynamically created agents

integer