phone_task_cancel

​

Parameters

​

Behavior

• Monitor the original task_id until it reports completed with terminal: "stopped_by_user".
• If the task finished before the cancel arrived, the response contains already_completed: true and nothing is sent to the phone - act on the task’s actual terminal instead.

​

Example

{
  "session_id": "session-uuid",
  "task_id": "task-uuid",
  "reason": "User changed their mind."
}

​

Related

• phone_session_end - cancel everything and close the workflow
• phone_task_pause - suspend instead of stopping