Skip to main content
POST
Approve or decline a suspended tool call

Authorizations

Authorization
string
header
required

JWT authentication token

Path Parameters

id
string<uuid>
required

Task ID

Body

application/json
decision
enum<string>
required

Whether to approve or decline the pending tool call

Available options:
approve,
decline
agent_id
string

Agent ID to resume (optional, resolved from stream metadata if omitted)

metadata
object

Answers or additional data to pass to the resumed tool (e.g., ask_question answers)

run_id
string

Agent run ID (optional, resolved from stream metadata if omitted)

tool_call_id
string

Specific tool call ID to approve (for parallel subagent routing)

Response

Approval processed successfully

success
boolean
required
error
string

Error message if approval failed

stream_id
string

ID of the resumed stream