Admin endpoints - Docs

Admin endpoints control the running Engine’s catalog and background work. They require X-Engine-Key and are typically called by ops tooling, not by application code.

POST /admin/reload-core-soul

Reload the soul template from the catalog directory. Use after editing catalog/core/core_soul.json (or whatever your catalog source of truth is) without restarting the Engine.

{ "status": "reloaded", "version": "..." }

POST /admin/reload-catalog

Reload all agents, skills, and tools from the catalog directory. Same non-restart hot reload as core soul, scoped wider.

{
  "status": "reloaded",
  "counts": {
    "agents": 5,
    "skills": 18,
    "tools": 24
  }
}

POST /admin/lc/trigger

Trigger an immediate Learning Centre batch run. The Learning Centre normally runs on its own schedule (LC_BATCH_INTERVAL_HOURS); this endpoint runs it now.

{
  "status": "started",
  "batch_id": "...",
  "trajectory_count": 12
}

The call returns as soon as the batch is enqueued. Watch the Engine logs to see it complete.

See also

Environment variables for LC_BATCH_INTERVAL_HOURS and friends.
Learning Centre for what runs in a batch.