Overview

The Agents API registers AI agents, manages their lifecycle status (active, suspended, deregistered), tracks key rotation history, and sets behavior baselines used during mandate evaluation.

Endpoints

MethodPathDescription
GET/agentsList agents with pagination
POST/agentsRegister a new agent (name, public_key, description, framework, runtime)
GET/agents/:idGet agent details
PATCH/agents/:idUpdate agent
DELETE/agents/:idDeregister (fails if active mandates)
PATCH/agents/:id/statusTransition status (active/suspended/deregistered)
GET/agents/:id/keysKey rotation history
GET/agents/:id/baselineGet behavior baseline
POST/agents/:id/baselineCreate/update baseline

Example

curl -X POST http://localhost:4000/agents \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer tr_abc123" \
  -d '{"name":"my-agent","public_key":"ed25519:abc...","framework":"langgraph"}'
PreviousAdminNextAlerts