Monitoring API - MeshAI Documentation

{
  "success": true,
  "data": {
    "total_agents": 12,
    "healthy": 9,
    "degraded": 2,
    "down": 1,
    "unknown": 0
  }
}

Fleet Overview

GET /monitoring/overview

Returns the count of agents in each status across the tenant.

curl https://api.meshai.dev/api/v1/monitoring/overview \
  -H "Authorization: Bearer msh_YOUR_API_KEY"

{
  "success": true,
  "data": {
    "total_agents": 12,
    "healthy": 9,
    "degraded": 2,
    "down": 1,
    "unknown": 0
  }
}

Agent Health Score

GET /agents/{agent_id}/health

Returns a composite health score (0-100) for a single agent, broken down into reliability, cost efficiency, and performance components. Backed by a 5-minute Redis cache; cached indicates whether the score was served from cache or computed fresh.

curl https://api.meshai.dev/api/v1/agents/01HQZXK3VJ3XZ9K8QYNPBC7G4T/health \
  -H "Authorization: Bearer msh_YOUR_API_KEY"

{
  "success": true,
  "data": {
    "agent_id": "01HQZXK3VJ3XZ9K8QYNPBC7G4T",
    "score": 87,
    "color": "green",
    "breakdown": {
      "reliability": {
        "score": 92,
        "weight": 0.4,
        "details": { "error_rate": 0.02, "uptime_pct": 99.1 }
      },
      "cost_efficiency": {
        "score": 80,
        "weight": 0.3,
        "details": { "daily_cost_trend": -0.05 }
      },
      "performance": {
        "score": 85,
        "weight": 0.3,
        "details": { "avg_latency_ms": 340.2, "p95_latency_ms": 890.5 }
      }
    },
    "computed_at": "2026-03-17T10:30:00Z",
    "cached": false
  }
}

Returns 404 Not Found if the agent does not exist in the tenant.