LiveLLM.Docs
API Reference · Agent Tasks

Get one agent task with its full trajectory

Get one agent task with its full trajectory

GET/v1/tenants/{name}/tasks/{taskId}

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.
taskIdstringrequired

Response

200 — The task, including its steps and result.

idstring
e.g. task_9f2c01ab34de
workloadIdstring
e.g. dev
promptstring
statusenum
One of: running · paused · done · failed · cancelled.
resultstring
The agent's final answer (once finished). While `paused` it carries the agent's question instead (`NEED_HUMAN: <question>`) — answer via the `/answer` endpoint.
stepsarray
The trajectory — one entry per tool call the agent made.
createdAtstring · date-time
finishedAtstring · date-time
curl https://api.live-llm.com/v1/tenants/acme/tasks/taskId \
  -H "x-api-key: $LIVELLM_KEY"
Try itGEThttps://api.live-llm.com/v1/tenants/{name}/tasks/{taskId}
Fill required path params: name, taskId.
Example response200
{
  "id": "task_8f31",
  "workloadId": "dev-box",
  "prompt": "Fix the failing login test",
  "status": "done",
  "result": "Fixed \\u2014 the mocked clock drifted; 3 files changed, tests green.",
  "steps": [
    {
      "title": "Reproduce the failure",
      "detail": "login.spec.ts:41 flaky under fake timers",
      "status": "done"
    },
    {
      "title": "Fix and re-run",
      "detail": "npm test \\u2014 214 passed",
      "status": "done"
    }
  ],
  "createdAt": "2026-08-02T09:00:00Z",
  "finishedAt": "2026-08-02T09:06:00Z"
}