> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kapso.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Handoff node

> Transfer workflow execution to human agents

Immediately stops workflow execution and transfers the conversation to human agents. Sets the workflow status to 'handoff' and prevents further automated processing.

## Configuration

* `id`: Unique node identifier

No other configuration needed - handoff nodes simply trigger the transfer.

## Workflow library example

```javascript theme={null}
workflow.addNode("handoff_to_team", {
  type: "handoff",
  reason: "needs_human",
  contextData: {
    priority: "{{vars.priority}}"
  }
});
```

## How it works

1. **Stops execution**: Immediately halts automated workflow processing
2. **Sets status**: Changes workflow execution status from 'running' to 'handoff'
3. **Prevents messages**: Blocks further automated message processing
4. **Requires intervention**: Human agents must manually handle the conversation

## Usage patterns

**Escalation workflow**

```mermaid theme={null}
graph LR
    A[Wait for response] --> B[Decide<br/>Issue complexity]
    B --> C[Send text<br/>Solution]
    B --> D[Handoff<br/>To human]
```