AIPing

GET ai/ping

A probe for monitoring. It checks the database, the knowledge index and the run queue, and returns a list of problem codes rather than a bare flag — an alert needs to say what is wrong.

No external request is made, so it can be polled often. The model provider is not contacted here: that call costs money.

Access Control

Any session. The method reads no customer data.

Response Data

{
  "ok": false,
  "problems": ["OPENROUTER_KEY_MISSING"],
  "service": "sct-ai",
  "nodeID": "sct-ai-1",
  "version": "0.0.1",
  "startedAt": "2026-09-17T09:41:12.000Z",
  "readyAt": "2026-09-17T09:41:13.100Z",
  "uptimeSec": 2604,
  "time": "2026-09-17T10:24:36.000Z",
  "database": { "ok": true, "latencyMs": 1 },
  "runs": { "active": 0, "byBrand": {}, "oldestAgeSec": 0 },
  "knowledge": { "ready": true, "documents": 52, "chunks": 203 }
}

Problem	Meaning
SERVICE_STARTING	The service has not finished starting
SERVICE_STOPPING	A shutdown is in progress
DATABASE_UNAVAILABLE	The module database does not answer
KNOWLEDGE_NOT_READY	The index is still building
KNOWLEDGE_FILES_FAILED	Some documents failed to parse
OPENROUTER_KEY_MISSING	No provider key: chat answers with an error
RUN_QUEUE_FULL	The queue is at its limit