Health + sync-freshness probe | KINETK Graph Service API

{
  "content": {
    "isStale": true,
    "lastMigratedAt": "2024-06-10T08:45:00Z",
    "minutesSinceMigration": 15.3
  },
  "db": "connected",
  "durationMs": 123.7,
  "narratives": {
    "isStale": true,
    "lastRunAt": "2024-06-10T07:30:00Z",
    "minutesSinceLastRun": 75
  },
  "stage": "production",
  "status": "error",
  "sync": {
    "isStale": true,
    "lastCycle": {
      "durationMs": 4500.5,
      "insertedCount": 1200,
      "processedCount": 1250
    },
    "lastRunAt": "2024-06-10T08:30:00Z",
    "minutesSinceLastRun": 15,
    "today": {
      "insertedCount": 15000,
      "processedCount": 15200
    }
  },
  "timestamp": "2024-06-10T08:46:00Z",
  "dbError": "Timeout while querying the primary database"
}

Liveness probe reporting connectivity and database sync freshness. Returns 503 when the database is unreachable.

Authentication

x-api-keystring

Customer secret key, required on every request. Validated natively by API Gateway; missing / invalid / revoked → 403.

Response headers

X-Kinetk-Credits-Useddouble

Credits consumed by this call (reserved estimate on a 202; actual once settled).

X-Kinetk-Credits-Remainingdouble

Account credit balance remaining after this call.

Response

Successful response

contentobject

dbenum

durationMsdouble

narrativesobject

stagestring

statusenum

syncobject

timestampstring

dbErrorstring

Errors

503

Service Unavailable Error

$	curl https://api.kinetk.ai/graph/health \
>	-H "x-api-key: <apiKey>" \
>	-H "Content-Type: application/json"