Admin API

Admin API

The Admin API provides system status, health checks, and administrative operations. These endpoints require admin-scoped API keys.

System Status

GET /v1/admin/status

Returns comprehensive system status including provider availability, queue depths, memory usage, and active connections.

curl https://api.optima-forge.com/v1/admin/status \
  -H "Authorization: Bearer $FORGE_ADMIN_KEY"

{
  "status": "healthy",
  "uptime_seconds": 864000,
  "version": "7.4.22",
  "providers": {
    "openai": { "status": "up", "latency_ms": 45 },
    "anthropic": { "status": "up", "latency_ms": 52 },
    "google": { "status": "up", "latency_ms": 38 }
  },
  "memory": {
    "vector": { "status": "up", "documents": 150000 },
    "graph": { "status": "up", "nodes": 45000 },
    "state": { "status": "up", "active_sessions": 230 }
  },
  "security": { "pipeline": "active", "scans_today": 45230 },
  "requests_today": 128450
}

Health Check

GET /v1/admin/health

Lightweight health check endpoint for load balancers and monitoring. Returns 200 OK when the service is healthy.

curl https://api.optima-forge.com/v1/admin/health

{ "status": "ok", "timestamp": 1709000000 }

Provider Management

GET /v1/admin/providers           # List all configured providers
POST /v1/admin/providers/:id/test  # Test provider connectivity
PUT /v1/admin/providers/:id        # Update provider configuration

Rate Limit Status

GET /v1/admin/rate-limits/:userId  # Check rate limit status for a user