Skip to content
Ishvana Ishvana Docs

Get detailed agent information

GET
/api/agent-communication/agents/{agent_id}

Retrieve hub-level details for a single registered agent.

Returns the agent’s capability profile, specializations, display name, authority level, and current availability flag. Used by the frontend agent inspector and by orchestration code that needs per-agent metadata before routing a task.

Path Parameters:

  • agent_id: Unique identifier of the target agent

Returns:

  • status: Operation status indicator
  • agent: :class:CommunicationHubAgentDetailsEntry with capabilities and availability
  • timestamp: ISO 8601 generation time

Raises:

  • HTTPException 404: If agent_id is not registered with the hub
  • HTTPException 503: If the communication hub is unavailable

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
agent_id
required
Agent Id
string

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Successful Response

CommunicationHubAgentDetailsResponse

Per-agent details response from the communication hub discovery endpoint.

Wraps a :class:CommunicationHubAgentDetailsEntry with operation status and an ISO 8601 timestamp, matching the envelope used by :class:AllAgentsResponse for consistency between list and detail endpoints.

object
status
required
Status

Operation status

string
agent
required
CommunicationHubAgentDetailsEntry

Detailed agent capability and availability data

object
agentId
required
Agentid

Registered agent ID

string
capabilities
required
Capabilities

Published capabilities

Array<string>
specializations
required
Specializations

Published specializations

Array<string>
agentName
required
Agentname

Display name for the agent

string
authorityLevel
required
Authoritylevel

Authority level from communication hub

string
availability
required
Availability

Whether the agent is currently available

boolean
timestamp
required
Timestamp

ISO 8601 timestamp

string

422

Section titled “422 ”

Validation Error

HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
input
Input
ctx
Context
object