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
| Method | Path | Description |
|---|---|---|
| GET | /agents | List agents with pagination |
| POST | /agents | Register a new agent (name, public_key, description, framework, runtime) |
| GET | /agents/:id | Get agent details |
| PATCH | /agents/:id | Update agent |
| DELETE | /agents/:id | Deregister (fails if active mandates) |
| PATCH | /agents/:id/status | Transition status (active/suspended/deregistered) |
| GET | /agents/:id/keys | Key rotation history |
| GET | /agents/:id/baseline | Get behavior baseline |
| POST | /agents/:id/baseline | Create/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"}'