> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stateset.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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…

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`

<ResponseField name="status" type="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.
</ResponseField>

<ResponseField name="in_flight_jobs" type="integer" required />

<ResponseField name="failed_last_hour" type="integer" required />

<ResponseField name="succeeded_last_hour" type="integer" required />

<ResponseField name="failure_rate_last_hour" type="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.
</ResponseField>

<ResponseField name="total_last_hour" type="integer" required />

<ResponseField name="last_used_at" type="string,null">
  ISO 8601 of when the calling API key was previously used. Useful for ops dashboards showing key activity timelines.
</ResponseField>

<ResponseField name="timestamp" type="string" required />

### Status codes

| Code  | Meaning             |
| ----- | ------------------- |
| `200` | Successful Response |

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
    --url 'https://api.computer.stateset.app/api/v1/system/health-detail' \
    --header 'X-API-Key: YOUR_API_KEY'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "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"
  }
  ```
</ResponseExample>