Need more info about Human Input Node

[dickens88]

Self Checks

• I have searched for existing issues search for existing issues, including closed ones.
• I confirm that I am using English to submit this report (我已阅读并同意 Language Policy).
• [FOR CHINESE USERS] 请务必使用英文提交 Issue，否则会被关闭。谢谢！:)
• Please do not modify this template :) and fill in all the required fields.

1. Is this request related to a challenge you're experiencing? Tell me about your story.

Hi,

I need more information about how to use the new feature Human Input node. There are 2 Delivery Method,

1. is it possible to call api to approve or reject the request?
2. the email can not be sent even i confiured the node... I guess i need to confiure the smtp somewhere, but i dont know how and where :/

2. Additional context or comments

No response

[dosubot[bot]]

Hi! Here's the info you need about the Human Input Node:

1. API for Approve/Reject

Yes, you can programmatically approve or reject requests via API. Submit the form using:

POST /api/form/human_input/<form_token>

{
  "inputs": {
    "field_name": "value"
  },
  "action": "action_id"
}

The action field corresponds to the action ID (e.g., approve/reject) configured in your node. You can get the form token and pause details from GET /console/api/workflow/<workflow_run_id>/pause-details.

2. Email SMTP Configuration

Email delivery requires configuring SMTP via environment variables (not in the UI). Add these to your .env file or Docker environment:

MAIL_TYPE=smtp
MAIL_DEFAULT_SEND_FROM=your-email@example.com
SMTP_SERVER=smtp.your-provider.com
SMTP_PORT=465
SMTP_USERNAME=your-username
SMTP_PASSWORD=your-password
SMTP_USE_TLS=true

See the full list in docker/.env.example.

Note: If you're self-hosting, ensure you have a Celery worker listening on the workflow_based_app_execution queue for emails to be sent and workflows to resume properly.

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}

   

[dickens88]

There are several questions about the reply.

1. The api to get the form token and pause details GET /console/api/workflow/<workflow_run_id>/pause-details is a frontend API which means it's hard to invoke from system integration. is there backend API provided that can be call with service API KEY?

2. What if i'd like to integrate this workflow (with HITL) with my APP, how can human user see which workflow needs approval? means how to get the pause status across all those workflows?

3. as for the email method, i think it's not a good idea to keep the password in the .env without encryption...