Agents API

The Agents API allows you to register, monitor, and manage the lifecycle of your AI agents within the ABS ecosystem.

Register Agent

POST /v1/agents/register

Register a new agent with a specific policy pack.

{
  "agent_id": "customer-support-bot",
  "name": "Customer Support",
  "policy_pack": "financial"
}

Heartbeat

POST /v1/heartbeat

Send a heartbeat signal to confirm agent liveness. See Heartbeat Sentinel for implementation details.

Get Agent Status

GET /v1/agents/{agent_id}

Retrieve real-time status and risk metrics for a specific agent.

Response

{
  "agent_id": "auditor-bot-prod-01",
  "status": "ACTIVE",
  "last_seen": "2026-02-13T10:05:00Z",
  "risk_score": 12,
  "policy_pack": "financial"
}