> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oneshotagent.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Goal Tasks

> List all tasks spawned by the orchestrator for a compute goal

## Overview

Lists every task the orchestrator spawned for a goal — tool calls, agent work, soul hires, and human approval checkpoints. Use this to track progress, see results, and understand what the orchestrator is doing.

## Path Parameters

<ParamField path="goalId" type="string" required>
  The goal ID returned from the create endpoint
</ParamField>

## Response

<ResponseField name="data" type="array">
  Array of tasks, ordered by most recent first.

  Each task includes:

  * `id` — Task ID
  * `task_type` — Type: `tool_call`, `agent_sandbox`, `soul_hire`, `human_approval`, `planning`, `evaluation`
  * `tool` — Which tool was used (e.g., `research`, `web_read`, `browser`, `build`, `email`, `soul_browse`)
  * `description` — What the task does
  * `status` — `pending`, `running`, `completed`, `failed`, `waiting`
  * `phase` — Which phase this task belongs to
  * `sequence` — Order within the phase
  * `progress_pct` — Progress percentage (0-100)
  * `progress_message` — Current progress description
  * `result` — Task output (when completed)
  * `quoted_usdc` — Budget reserved for this task
  * `actual_usdc` — Actual cost incurred
  * `started_at`, `completed_at`, `created_at` — Timestamps
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl https://win.oneshotagent.com/v1/compute/goal_01HX8K3YZ/tasks \
    -H "Content-Type: application/json"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "data": [
      {
        "id": "task_002",
        "task_type": "tool_call",
        "tool": "build",
        "description": "Build comparison landing page with research findings",
        "status": "running",
        "phase": 2,
        "sequence": 1,
        "progress_pct": 45,
        "progress_message": "Generating page sections...",
        "result": null,
        "quoted_usdc": "3.000000",
        "actual_usdc": null,
        "started_at": "2026-01-15T12:05:00Z",
        "created_at": "2026-01-15T12:04:55Z"
      },
      {
        "id": "task_001",
        "task_type": "tool_call",
        "tool": "research",
        "description": "Research top 10 AI agent frameworks",
        "status": "completed",
        "phase": 1,
        "sequence": 1,
        "progress_pct": 100,
        "progress_message": "Research complete",
        "result": "Identified 10 frameworks: LangChain, CrewAI, AutoGen...",
        "quoted_usdc": "1.000000",
        "actual_usdc": "0.850000",
        "started_at": "2026-01-15T12:00:30Z",
        "completed_at": "2026-01-15T12:04:50Z",
        "created_at": "2026-01-15T12:00:25Z"
      },
      {
        "id": "task_000",
        "task_type": "tool_call",
        "tool": "soul_browse",
        "description": "Browse soul marketplace for research specialists",
        "status": "completed",
        "phase": 1,
        "sequence": 0,
        "progress_pct": 100,
        "result": {
          "souls": [
            { "slug": "deep-researcher", "name": "Deep Researcher", "category": "research" }
          ],
          "total": 1
        },
        "quoted_usdc": "0",
        "actual_usdc": "0",
        "completed_at": "2026-01-15T12:00:10Z",
        "created_at": "2026-01-15T12:00:09Z"
      }
    ]
  }
  ```
</ResponseExample>