Skip to main content
POST

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

string
required
The goal ID containing the approval task

Request Body

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

Response

string
The approval task ID
string
The parent goal ID
string
completed (approved) or failed (denied)
string
What the orchestrator did next
The task must be of type human_approval and in waiting status. The orchestrator automatically wakes after receiving a response.