For the complete documentation index, see llms.txt. This page is also available as Markdown.

get_task()

get_task()

Fetch the current state of a task

The shape of the result depends on the flags: lite=true returns a minimal status payload, verbose=true returns the full raw task data, and the default (verbose=false) returns the standard task result (with answer fields for jobs that produce one).

Arguments

{
  "task_id": "019cd179-8d61-7f65-a79c-b965dda9eac3",
  "lite": false,
  "verbose": false
}

Returns

Task state; concrete type depends on lite/verbose and job.

The exact shape varies (TaskResponse, PQATaskResponse, TaskResponseVerbose, LiteTaskResponse). The example below shows the most common case.

{
  "status": "string",
  "query": "string",
  "user": "string",
  "created_at": "2026-06-03T08:00:00Z",
  "job_name": "string",
  "share_status": "string",
  "permitted_accessors": {},
  "build_owner": "string",
  "environment_name": "string",
  "agent_name": "string",
  "task_id": "019cd179-8d61-7f65-a79c-b965dda9eac3",
  "project_id": "019cd179-8d61-7f65-a79c-b965dda9eac3",
  "answer": "string",
  "formatted_answer": "string",
  "answer_reasoning": "string",
  "has_successful_answer": true,
  "total_cost": 0,
  "total_queries": 0
}

Last updated