System Health Detail V1

Extended operational health beyond the basic liveness ping. Tenant-scoped: the failure-rate signal reflects this tenant’s jobs only, not the whole platform…

GET /api/v1/system/health-detail

cURL

curl --request GET \
  --url 'https://api.computer.stateset.app/api/v1/system/health-detail' \
  --header "X-API-Key: $STATESET_COMPUTER_USE_API_KEY"

200

{
  "status": "ok",
  "in_flight_jobs": 1,
  "failed_last_hour": 1,
  "succeeded_last_hour": 1,
  "failure_rate_last_hour": 7.5,
  "total_last_hour": 1,
  "last_used_at": "2026-08-31T14:22:05Z",
  "timestamp": "2026-08-31T14:22:05Z"
}

Extended operational health beyond the basic liveness ping.

Tenant-scoped: the failure-rate signal reflects this tenant’s jobs only, not the whole platform. Useful for dashboards that want a one-stop ‘is my integration healthy right now?’ panel.

Response

HealthDetailResponse

status · string · required

Aggregate signal: ok when nothing’s flagged, degraded when in-flight count or failure rate crosses warning thresholds, unhealthy when the DB itself is unreachable.

in_flight_jobs · integer · required

failed_last_hour · integer · required

succeeded_last_hour · integer · required

failure_rate_last_hour · number · required

failed / (succeeded + failed) over the last hour. 0.0 when no terminal jobs landed in that window — does not signal health by itself, callers should weigh total_last_hour first.

total_last_hour · integer · required

last_used_at · string,null

ISO 8601 of when the calling API key was previously used. Useful for ops dashboards showing key activity timelines.

timestamp · string · required

Status codes

Code	Meaning
200	Successful Response

cURL

curl --request GET \
  --url 'https://api.computer.stateset.app/api/v1/system/health-detail' \
  --header "X-API-Key: $STATESET_COMPUTER_USE_API_KEY"

200

{
  "status": "ok",
  "in_flight_jobs": 1,
  "failed_last_hour": 1,
  "succeeded_last_hour": 1,
  "failure_rate_last_hour": 7.5,
  "total_last_hour": 1,
  "last_used_at": "2026-08-31T14:22:05Z",
  "timestamp": "2026-08-31T14:22:05Z"
}