Returns the project’s agent registry, sorted by name. An agent row exists for every distinct
agent the engine has seen: agents are auto-registered the first time a root trace arrives
under a new name, and can also be registered explicitly with
Register Agent. Use this list to find the agent ids that
monitoring profiles, patterns, and online-evaluator scopes key off.
There is no separate “tracked agents” list on the self-host engine - every registered agent’s
traces appear in Live Traces. This endpoint replaces the hosted platform’s
/ingest/tracked-agents surface.
Authentication
string
required
Project API key.
Response
array
Array of agent objects, sorted by name. Each has:
Field
Type
Description
_id
string
Agent ID - pass as agentId on trace ingest, monitoring profiles, and scope arrays
name
string
Display name (two agents may deliberately share one; see Register Agent)
kind
string
Always "agent"
agentType
string
Always "external" on self-host (agents arrive via SDK/dashboard registration, never a native agent builder)
monitoringAgentId
string
Same value as _id
monitoringProfile
object | null
The agent’s monitoring profile, or null when none has been configured. Includes _id, agentId, enabled, failureDetectionEnabled, infoDetectionEnabled, topicsEnabled, sampleRate, retentionDays, thresholdOverrides, channels, coverageMode, approvalPolicy, timestamps, and hosted-compatibility constants (workspaceId: "local", billingMode: "credits", pausedForCredits: false)