genroc

docs / Reference / REST API

Debug

The 2 HTTP endpoints under Debug.

GET /healthz

Readiness probe: 200 when this worker can reach its database, 503 when it cannot

Needs no credential.

Response

{
  "status": "ok",
  "worker_id": "genroc-7f3c-1",
  "database": "postgres",
  "lease_age_ms": 1200,
  "manual_tick": false
}

Fails with 400, 500, 503.

POST /api/tick

Manually trigger one engine poll cycle (useful when started with -poll 0); optionally shift the server clock forward first to expire leases and retry timers without real waits (testing only)

Requires the admin permission.

Request

{
  "advance_ms": 12000
}

Response

{
  "count": 0
}

Fails with 400, 500, 501.