Skip to main content
GET
/
api
/
v1
/
agents
List Agents (Inventory)
curl --request GET \
  --url http://localhost:8000/api/v1/agents
{
  "agent_id": "<string>",
  "name": "<string>",
  "framework": "<string>",
  "role": "<string>",
  "model": "<string>",
  "tools_observed": [
    "<string>"
  ],
  "tool_call_counts": {},
  "total_tool_calls": 123,
  "system_prompt": "<string>",
  "system_prompt_hash": "<string>",
  "run_count": 123,
  "observation_count": 123,
  "maturity": "<string>",
  "first_seen": "<string>",
  "last_seen": "<string>"
}

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 as an AgentSummary. Compared to /risk/agents, this endpoint also exposes tool_call_counts, total_tool_calls, and the raw system_prompt.

​
Query Parameters

​
service
string
Filter agents by service name.

​
Response

Array of agent objects:
​
agent_id
string
Unique identifier
​
name
string
Human-readable name
​
framework
string
Detected framework
​
role
string
Agent role/purpose
​
model
string
LLM model in use
​
tools_observed
string[]
Tool names invoked by this agent
​
tool_call_counts
object
Map of tool_name to invocation count
​
total_tool_calls
integer
Sum of all tool calls
​
system_prompt
string
System prompt text (may be empty)
​
system_prompt_hash
string
SHA-256 hash of the system prompt (first 16 hex chars)
​
run_count
integer
Number of distinct runs
​
observation_count
integer
Total spans observed
​
maturity
string
LEARNING or MATURE
​
first_seen
string
ISO-8601 timestamp
​
last_seen
string
ISO-8601 timestamp