API Reference · Activity

One aggregated realtime snapshot of the workspace

Collapses the per-tab poll fan-out into a SINGLE request. Returns, gathered server-side and in-cluster: the full workload `status` (identical to `GET /status`), an `agents` busy map keyed `daemon:<id>` / `master:<id>`, the `asksCount` + newest ask id, and cheap `latestActivityId` / `latestTaskTs` change-tokens. A daemon the idle sweep parked is reported `{busy:false, sleeping:true}` with NO network call — sleeping daemons are never contacted. The whole response is cached per workspace for ~2s, so many tabs polling every few seconds collapse to a couple of real gathers.

GET/v1/tenants/{name}/pulse

Authorization

x-api-keystringrequired
Your per-workspace API key, e.g. llc_AbC123…. Also accepted as Authorization: Bearer <key>. Mint keys on your workspace's API keys page — each key belongs to one workspace.

Path parameters

namestringrequired
Workspace (tenant) name.

Response

200The aggregated workspace snapshot.

statusobject
The full TenantStatus, identical to GET /status.
agentsobject
Per-agent liveness, keyed "daemon:<id>" / "master:<id>".
asksCountinteger
Paused asks across the workspace (matches GET /asks count).
latestAskIdstring
Task id of the newest ask — a change-token for the inbox.
latestActivityIdinteger
Highest activity event id — refetch the feed when it changes.
latestTaskTsstring · date-time
Most recent agent-task activity time.
curl https://api.live-llm.com/v1/tenants/acme/pulse \
  -H "x-api-key: $LIVELLM_KEY"
Try itGEThttps://api.live-llm.com/v1/tenants/{name}/pulse
Fill required path param: name.
Example response200
{
  "status": {
    "phase": "Ready"
  },
  "agents": {
    "dev-box": {
      "busy": false,
      "sleeping": true,
      "sessions": [],
      "tasks": {
        "running": 0
      }
    }
  },
  "asksCount": 0,
  "latestAskId": "",
  "latestActivityId": 1187,
  "latestTaskTs": "2026-08-02T09:06:00Z"
}