agent_id that appears in an evaluation or ingest request. The two agent management endpoints let you inspect the full list of agents for your organization and optionally pre-register an agent before its first evaluation.
Agents are created automatically on the first call to
/v1/evaluate or /v1/ingest that references a new agent_id. Explicit registration via POST /v1/agents is optional — use it when you want the agent to appear in the dashboard before any evaluations have run.GET /v1/agents — list agents
Returns all agents for your organization, sorted bylast_seen descending (most recently active first). Up to 500 agents are returned.
Endpoint
Authentication
Required. Pass your API key as a Bearer token:Response fields
array
Array of agent objects, sorted by
last_seen descending.Example request
Example response
POST /v1/agents — register an agent
Explicitly registers an agent by ID. If the agent already exists, the call succeeds silently without overwriting any data.Endpoint
Authentication
Required. Pass your API key as a Bearer token:Request body
string
required
Identifier for the agent to register. Must be between 1 and 200 characters. Use the same value you will pass as
agent_id in evaluations.Response fields
The server responds with201 Created.
string
The registered agent identifier, echoed back from the request.
boolean
Always
true on success.