task.confirmAction

Confirms a pending action to resume the task. Use when task.listMessages shows agent_status: "waiting". For messageAskUser events, use task.sendMessage instead. See the Task Lifecycle guide for input formats.

POST /v2/task.confirmAction

ConfirmAction

cURL

curl --request POST \
  --url https://api.manus.ai/v2/task.confirmAction \
  --header 'Content-Type: application/json' \
  --data '
{
  "task_id": "<string>",
  "event_id": "<string>"
}
'

200

{
  "ok": true,
  "request_id": "<string>",
  "task_id": "<string>",
  "confirmed": true
}

^{Questions or issues? Contact us at [e-mail].}

OAuth scope: create_task or manage_all_tasks — see the OAuth2 guide. With create_task scope, can only access tasks created by this OAuth app.

Input format: Depends on waiting_for_event_type from the status_update event. Check the confirm_input_schema field in the event for the expected JSON Schema. See the Task Lifecycle guide for all event types and examples.

messageAskUser: Use task.sendMessage instead — do not use this endpoint for agent questions.

Headers

x-manus-api-key · string

API key for direct authentication. Provide either this or Authorization, not both. See Authentication.

Authorization · string

OAuth2 access token in Bearer {token} format. Provide either this or x-manus-api-key, not both. See the OAuth2 guide.

Example:

"Bearer {access_token}"

Body

application/json

task_id · string · required

The unique identifier of the task with a pending action. Supports the shortcut agent-default-main_task for the IM agent's main task.

event_id · string · required

The waiting_for_event_id value from the status_update event that triggered the confirmation request. This identifies which specific action to confirm.

input · object

Optional input data for the pending action. The expected schema is defined by the confirm_input_schema field in the status_update event. For simple confirmations, this can be omitted.

Response

200

application/json

Action confirmed successfully. The task will resume processing.

ok · boolean

Whether the request was successful.

Example:

true

request_id · string

Unique identifier for this API request.

task_id · string

The ID of the task that was confirmed.

confirmed · boolean

Always true when the confirmation was accepted.