Skip to main content
GET
/
v1
/
compute
/
{goalId}
curl https://win.oneshotagent.com/v1/compute/goal_01HX8K3YZ \
  -H "Content-Type: application/json"

{
  "success": true,
  "data": {
    "id": "goal_01HX8K3YZ...",
    "status": "active",
    "name": "Research AI frameworks and build comparison page",
    "objective": "Research the top 10 AI agent frameworks...",
    "current_phase": 2,
    "plan": {
      "phases": [
        { "name": "Research", "tasks": 3 },
        { "name": "Build", "tasks": 2 },
        { "name": "Deliver", "tasks": 1 }
      ]
    },
    "budget": {
      "total": "8.500000",
      "spent": "2.150000",
      "reserved": "3.000000",
      "remaining": "3.350000"
    },
    "started_at": "2026-01-15T12:00:00Z",
    "last_wake_at": "2026-01-15T12:05:30Z",
    "created_at": "2026-01-15T12:00:00Z"
  }
}

​
Overview

Check where a compute goal stands: status, current phase, plan, budget, and timing.

​
Path Parameters

​
goalId
string
required
The goal ID returned from the create endpoint

​
Response

​
data.id
string
Goal ID
​
data.status
string
Goal status: active, completed, cancelled, failed
​
data.name
string
Short name for the goal
​
data.objective
string
Full objective text
​
data.current_phase
integer
Current execution phase
​
data.plan
object
Orchestrator’s execution plan
​
data.budget
object
Budget summary with total, spent, reserved, remaining (all in USDC)
​
data.soul_agent_id
string
Associated soul agent ID (if any)
​
data.started_at
string
When execution began
​
data.completed_at
string
When the goal completed (if finished)
​
data.last_wake_at
string
Last time the orchestrator woke for this goal
​
data.next_wake_at
string
Scheduled next wake (if waiting)
​
data.wake_version
integer
Wake version counter. Increments each time the orchestrator schedules a new wake, used to discard stale scheduled wakes.
curl https://win.oneshotagent.com/v1/compute/goal_01HX8K3YZ \
  -H "Content-Type: application/json"

{
  "success": true,
  "data": {
    "id": "goal_01HX8K3YZ...",
    "status": "active",
    "name": "Research AI frameworks and build comparison page",
    "objective": "Research the top 10 AI agent frameworks...",
    "current_phase": 2,
    "plan": {
      "phases": [
        { "name": "Research", "tasks": 3 },
        { "name": "Build", "tasks": 2 },
        { "name": "Deliver", "tasks": 1 }
      ]
    },
    "budget": {
      "total": "8.500000",
      "spent": "2.150000",
      "reserved": "3.000000",
      "remaining": "3.350000"
    },
    "started_at": "2026-01-15T12:00:00Z",
    "last_wake_at": "2026-01-15T12:05:30Z",
    "created_at": "2026-01-15T12:00:00Z"
  }
}