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.