Security Metrics

Get security-specific metrics. Requires admin role.

GET /metrics/security

cURL

curl --request GET \
  --url 'http://localhost:8000/metrics/security' \
  --header "Authorization: Bearer $STATESET_AGENTS_API_KEY"

200

{
  "timestamp": "2026-08-31T14:22:05Z",
  "statistics": {},
  "recent_events": [
    {
      "type": "standard",
      "threat_level": "string",
      "blocked": false,
      "path": "string",
      "timestamp": "2026-08-31T14:22:05Z"
    }
  ]
}

Get security-specific metrics. Requires admin role.

Response

object

timestamp · string (date-time) · required

statistics · object · required

Counters from the security monitor

recent_events · object[] · required

Show recent_events

type · string

threat_level · string

blocked · boolean

path · string

timestamp · string (date-time)

Status codes

Code	Meaning
200	Successful response
401	Authentication required
403	Insufficient permissions
422	Validation error
429	Rate limit exceeded

cURL

curl --request GET \
  --url 'http://localhost:8000/metrics/security' \
  --header "Authorization: Bearer $STATESET_AGENTS_API_KEY"

200

{
  "timestamp": "2026-08-31T14:22:05Z",
  "statistics": {},
  "recent_events": [
    {
      "type": "standard",
      "threat_level": "string",
      "blocked": false,
      "path": "string",
      "timestamp": "2026-08-31T14:22:05Z"
    }
  ]
}