task.confirmAction
Confirms a supported pending action when task.listMessages shows agent_status: waiting. Build input according to confirm_input_schema and review the event identified by waiting_for_event_id for tool params and result. For messageAskUser / cascadeAskUser questions, use task.sendMessage instead. See the Task Lifecycle guide; do not automatically confirm unrecognized waiting types.
Headers
API key for direct authentication. Provide either this or Authorization, not both. See Authentication.
Body
The unique identifier of the task with a pending action. Supports the shortcut agent-default-main_task for the IM agent's main task.
The waiting_for_event_id value from the status_update event that triggered the confirmation request. This identifies which specific action to confirm.
Optional input data for the pending action. Build it according to status_update.confirm_input_schema. For simple confirmations, input can be omitted.
Response
Confirmation request processed. Check confirmed to determine whether a confirmation event was submitted.
Whether the request was successful.
true
Unique identifier for this API request.
The ID of the task that was confirmed.
True when a confirmation event was submitted. False when the input was valid but the pending action did not consume it; the task remains waiting. True does not mean the external operation completed successfully.