Skip to main content
When a workflow reaches a Human Input node, it pauses and emits a human_input_required event in the streaming response. The event carries a form_token that your integration uses to drive the form lifecycle until the workflow resumes. For per-endpoint reference, see the Human Input API.

​
Steps

The sequence below applies to both Workflow and Chatflow apps. Only the entry endpoint in Step 1 differs between the two.
1

Start the app in streaming mode

  1. Call Run Workflow (Workflow apps) or Send Chat Message (Chatflow apps), passing your end user’s user identifier.
  2. Watch the SSE stream for the human_input_required event and capture its form_token. If form_token is null, the form uses Email delivery and can’t be driven via the API (see Delivery Method Requirement). The human_input_required event also carries the run’s workflow_run_id; keep it in case you need to resume listening in Step 4.
2

Get the form definition

Call Get Human Input Form with form_token. The response includes the rendered Markdown, input field definitions, available actions, pre-filled default values, and an expiration_time after which the form can no longer be submitted. Render the form for the recipient.If the form expires before it is submitted, the paused run follows the node’s configured timeout behavior; a resumed stream then carries human_input_form_timeout rather than human_input_form_filled.
3

Submit the response

Call Submit Human Input Form with the recipient’s input values, the selected action, and your user. The action must be one of the actions from the form definition in Step 2.A successful submit is final: it closes the form and resumes the run along the matching action branch, so the same form_token can’t be submitted again.A rejected submit (an invalid action or a missing required input) leaves the form unchanged—fix the inputs and resubmit with the same form_token.
4

Resume listening to the workflow

If the original SSE stream closed, reopen it via Stream Workflow Events with the workflow_run_id from Step 1 and the same user that started the run—a different user gets a 404.The resumed stream includes human_input_form_filled confirming the submission (or human_input_form_timeout if the form expired), then the remaining node events through to completion, like a run that never paused.Add include_state_snapshot=true to first replay the status of nodes that already executed. If the workflow has more than one Human Input node in sequence, the stream closes at each pause by default; pass continue_on_pause=true to keep one stream open across all of them.

​
Delivery Method Requirement

The Human Input API works only with forms delivered via the Human Input node’s WebApp method. Email-only delivery doesn’t expose a form_token.

​
Example: Form Submission

This example uses a form with a feedback paragraph input and approve / reject actions.
  1. Call Get Human Input Form to get the form definition:
    Returns the form definition:
  2. Call Submit Human Input Form with the recipient’s input and selected action:
    Returns {}. The workflow resumes along the approve branch.
  3. Reconnect to the run’s stream with Stream Workflow Events to follow it through to completion, as in the final step of the sequence above.