Skip to main content
GET
/
api
/
v1
/
risk
/
agents
List Agents
curl --request GET \
  --url http://localhost:8000/api/v1/risk/agents
[
  {
    "agent_id": "researcher-agent",
    "name": "Researcher",
    "framework": "langchain",
    "role": "Research and analysis",
    "model": "gpt-4o",
    "tools_observed": ["search_documents", "fetch_url"],
    "system_prompt_hash": "a1b2c3d4e5f67890",
    "run_count": 15,
    "observation_count": 234,
    "maturity": "MATURE",
    "first_seen": "2026-03-15T10:30:00Z",
    "last_seen": "2026-03-17T14:22:00Z"
  }
]

Documentation Index

Fetch the complete documentation index at: https://docs.tracectrl.ai/llms.txt

Use this file to discover all available pages before exploring further.

Returns every agent in the inventory with their observation counts, tools, maturity status, and framework detection.

Response

Array of agent objects with the same fields as the Get Agent Detail endpoint.
[
  {
    "agent_id": "researcher-agent",
    "name": "Researcher",
    "framework": "langchain",
    "role": "Research and analysis",
    "model": "gpt-4o",
    "tools_observed": ["search_documents", "fetch_url"],
    "system_prompt_hash": "a1b2c3d4e5f67890",
    "run_count": 15,
    "observation_count": 234,
    "maturity": "MATURE",
    "first_seen": "2026-03-15T10:30:00Z",
    "last_seen": "2026-03-17T14:22:00Z"
  }
]