Integration Health API

Monitor the health and reliability of your space's integrations.

Endpoints Overview

Method	Endpoint	Description
GET	/spaces/{slug}/integration-health	Get health summary

---

Get Space Health

GET /spaces/{slug}/integration-health

Returns aggregated health metrics for all integrations in a space over a configurable lookback window.

Query Parameters

Parameter	Type	Default	Description
days	integer	30	Lookback window in days

Response

{
  "space_id": "uuid",
  "period_days": 30,
  "total_events": 1250,
  "success_count": 1180,
  "error_count": 70,
  "success_rate": 94.4,
  "last_success_at": "2026-02-17T10:00:00Z",
  "last_error_at": "2026-02-16T08:30:00Z",
  "by_integration_type": [
    {
      "integration_type": "metadata_sync",
      "total": 800,
      "success": 780,
      "errors": 20,
      "last_event_at": "2026-02-17T10:00:00Z"
    },
    {
      "integration_type": "quality_check",
      "total": 350,
      "success": 320,
      "errors": 30,
      "last_event_at": "2026-02-17T09:45:00Z"
    }
  ]
}

Response Fields

Field	Type	Description
space_id	string	Space identifier
period_days	integer	Lookback window used
total_events	integer	Total integration events in the period
success_count	integer	Events with SUCCESS status
error_count	integer	Events with ERROR status
success_rate	float	Success percentage (0.0–100.0)
last_success_at	string | null	ISO timestamp of most recent success
last_error_at	string | null	ISO timestamp of most recent error
by_integration_type	array	Breakdown per integration type

Integration Types

Type	Description
metadata_sync	Connector metadata synchronization
quality_check	Quality check execution
profiling	Data profiling runs
webhook	Outbound webhook delivery
alert	Alert connector notifications

---

Use Cases

• Dashboard widgets — Display health scores and trend sparklines
• Alerting — Trigger notifications when success_rate drops below a threshold
• SLA monitoring — Track last_success_at to detect stale integrations
• Trend analysis — Compare health metrics across multiple spaces at the organization level