LiveLLM.Docs
API Reference · Agent Tasks

Push an agent busy-state transition (internal, agent-sa)

A workspace daemon/master's status-server POSTs here when its busy state TRANSITIONS — derived from opencode's own `/event` SSE, in-pod. The platform fans it to open tabs as an `agent-busy` stream frame AND marks the daemon active, so a genuinely-working daemon is never scaled to zero by the idle sweep. Authenticated by the workspace agent-sa ServiceAccount token; not part of the public user API.

POST/v1/tenants/{name}/workloads/{id}/agent-busy

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.
idstringrequired
Workload id within the workspace.

Body

busybooleanrequired
Whether the agent is running a task now.
sessionsarrayoptional
Running opencode session ids (optional).
tasksobjectoptional
Running session id → title (optional).

Response

200 — Transition accepted and fanned out.

okboolean
curl -X POST https://api.live-llm.com/v1/tenants/acme/workloads/web/agent-busy \
  -H "x-api-key: $LIVELLM_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "busy": true,
    "sessions": [
      "Refactor the billing tests"
    ],
    "tasks": {
      "running": 1
    }
  }'
Try itPOSThttps://api.live-llm.com/v1/tenants/{name}/workloads/{id}/agent-busy
Fill required path params: name, id.
Example response200
{
  "ok": true
}