Guardian

GET /v1/guardian/status

Get platform health status. No authentication required.

curl https://agents.systemr.ai/v1/guardian/status

Response (200):

{
  "platform": "System R",
  "status": "operational",
  "uptime_seconds": 864000,
  "latency_ms": 12,
  "version": "2.1.0"
}

Field	Type	Description
status	string	operational, degraded, or maintenance.
uptime_seconds	int	Seconds since last restart.
latency_ms	int	Current API latency in milliseconds.
version	string	Platform version.

---

POST /v1/guardian/report

Report an issue encountered by the agent. No admin auth required.

curl -X POST https://agents.systemr.ai/v1/guardian/report \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "agt_a1b2c3d4",
    "report_type": "error",
    "description": "calculate_kelly returned NaN for valid 5-trade input",
    "details": {
      "tool_name": "calculate_kelly",
      "input_count": 5
    }
  }'

Field	Type	Required	Description
agent_id	string	Yes	Agent filing the report.
report_type	string	Yes	error, degradation, or suspicious_activity.
description	string	Yes	Description of the issue.
details	object	No	Additional context.

Response (200):

{
  "event_id": "evt_xyz789",
  "status": "recorded"
}

---

GET /v1/guardian/events

Get recent security events. Requires admin authentication via X-Admin-Key header.

curl "https://agents.systemr.ai/v1/guardian/events?limit=50&severity=critical" \
  -H "X-Admin-Key: ADMIN_KEY"

Parameter	Type	Default	Description
limit	int	100	Max events (max 1000).
category	string	None	Filter by event category.
severity	string	None	Filter by severity level.

Response (200):

{
  "events": [
    {
      "event_id": "evt_abc123",
      "type": "agent_report",
      "severity": "warning",
      "description": "Agent reported tool error",
      "agent_id": "agt_a1b2c3d4",
      "timestamp": "2026-03-25T14:30:00Z"
    }
  ],
  "count": 1,
  "filters": {
    "category": null,
    "severity": "critical",
    "limit": 50
  }
}

---

GET /v1/guardian/alerts

Get active alerts (CRITICAL and EMERGENCY events). Requires admin authentication.

curl "https://agents.systemr.ai/v1/guardian/alerts?limit=20" \
  -H "X-Admin-Key: ADMIN_KEY"

Parameter	Type	Default	Description
limit	int	50	Max alerts (max 500).

Response (200):

{
  "alerts": [],
  "count": 0
}

---

GET /v1/guardian/metrics

Get system metrics. Requires admin authentication.

curl https://agents.systemr.ai/v1/guardian/metrics \
  -H "X-Admin-Key: ADMIN_KEY"

Response (200):

{
  "uptime_seconds": 864000,
  "total_events": 1542,
  "error_rate": "0.002",
  "latency_p50_ms": 8,
  "latency_p95_ms": 45,
  "latency_p99_ms": 120,
  "active_agents": 23,
  "total_tool_calls_24h": 4521
}