agent connections
Get Connection Detail
Get detail for one connection of a given agent.
Returns agent, memory_sources, recent_sessions (at most the connection’s one session), recent_traces and recent_qas, the last two capped at the 20 most recent entries. Without agent_session_name only active connections are considered and the most recently active one is returned; a named lookup also finds deactivated ones. An agent_id that is neither the caller nor one of their agents, or no matching connection, returns 404.
Path Parameters
- agent_id (UUID): The agent’s user ID (from GET /api/v1/agents/list).
Query Parameters
- agent_session_name (Optional[str]): Filter by connection name within the agent’s connections. A named lookup also returns inactive (unregistered) connections; check agent.status.
GET
Get Connection Detail
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Query Parameters
Filter by connection name within the agent's connections. A named lookup also returns inactive (unregistered) connections; check agent.status.
Response
Successful Response