LiveLLM.Docs
API Reference · Agent Tasks

Dispatch a task to the workload's AI daemon

Fire-and-forget: the prompt starts a **new** session on the workload's AI daemon and returns immediately with a task id. The platform follows the run server-side, recording each tool call as a trajectory step and the agent's final answer as `result`. Poll the task until its status leaves `running`. Requires the workload to have an enabled AI daemon.

POST/v1/tenants/{name}/workloads/{id}/task

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

promptstringrequired
e.g. install nginx and serve /var/www
channelIdstringoptional
Optional alert channel to notify on completion.

Response

202 — Accepted — the agent is working.

idstring
e.g. task_9f2c01ab34de
workloadIdstring
statusenum
One of: running.
createdAtstring · date-time
curl -X POST https://api.live-llm.com/v1/tenants/acme/workloads/web/task \
  -H "x-api-key: $LIVELLM_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Update all npm dependencies and run the tests",
    "channelId": ""
  }'
Try itPOSThttps://api.live-llm.com/v1/tenants/{name}/workloads/{id}/task
Fill required path params: name, id.
Example response202
{
  "id": "task_8f31",
  "workloadId": "dev-box",
  "status": "running",
  "createdAt": "2026-08-02T09:00:00Z"
}