Skip to main content
POST
/
v1
/
compute
/
{goalId}
/
respond
curl -X POST https://win.oneshotagent.com/v1/compute/goal_01HX8K3YZ/respond \
  -H "Content-Type: application/json" \
  -H "X-Agent-ID: 0xYourWalletAddress" \
  -d '{
    "task_id": "task_005",
    "approved": true,
    "response": "Looks good, proceed with sending"
  }'

{
  "success": true,
  "data": {
    "task_id": "task_005",
    "goal_id": "goal_01HX8K3YZ...",
    "task_status": "completed",
    "orchestrator_action": "continue_execution"
  }
}

​
Overview

The orchestrator sometimes pauses for human approval before doing something expensive or sensitive (e.g., confirming a purchase, signing off on a draft email). Use this endpoint to approve, deny, or add instructions.

​
Authentication

Send your agent wallet address in the X-Agent-ID header. Only the wallet that created the goal can respond to its approval tasks.

​
Path Parameters

​
goalId
string
required
The goal ID containing the approval task

​
Request Body

​
task_id
string
required
The task ID of the human_approval task (from the tasks endpoint)
​
approved
boolean
Whether to approve (true) or deny (false) the task. Defaults to true if omitted.
​
response
string
Optional text response or guidance for the orchestrator.

​
Response

​
data.task_id
string
The approval task ID
​
data.goal_id
string
The parent goal ID
​
data.task_status
string
completed (approved) or failed (denied)
​
data.orchestrator_action
string
What the orchestrator did next
curl -X POST https://win.oneshotagent.com/v1/compute/goal_01HX8K3YZ/respond \
  -H "Content-Type: application/json" \
  -H "X-Agent-ID: 0xYourWalletAddress" \
  -d '{
    "task_id": "task_005",
    "approved": true,
    "response": "Looks good, proceed with sending"
  }'

{
  "success": true,
  "data": {
    "task_id": "task_005",
    "goal_id": "goal_01HX8K3YZ...",
    "task_status": "completed",
    "orchestrator_action": "continue_execution"
  }
}
The task must be of type human_approval and in waiting status. The orchestrator automatically wakes after receiving a response.