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.

---

Docs are dead. Just use Dosu.

[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...

[xXMrNidaXx]

Human Input Node requires both API setup and SMTP configuration.

1. API Approval/Rejection:

Yes, you can call API to approve/reject:

# Get pending human input
GET /api/workflows/{workflow_run_id}

# Approve
POST /api/workflows/{workflow_run_id}/human-input
{
  "action": "approve",
  "inputs": {"comment": "Approved by API"}
}

# Reject
POST /api/workflows/{workflow_run_id}/human-input
{
  "action": "reject",
  "reason": "Not meeting criteria"
}

2. SMTP Configuration:

Configure in docker-compose.yml or .env:

# docker-compose.yml
services:
  api:
    environment:
      - MAIL_TYPE=smtp
      - SMTP_SERVER=smtp.gmail.com
      - SMTP_PORT=587
      - SMTP_USERNAME=your-email@gmail.com
      - SMTP_PASSWORD=your-app-password
      - SMTP_USE_TLS=true
      - MAIL_DEFAULT_SEND_FROM=your-email@gmail.com

Or in .env file:

MAIL_TYPE=smtp
SMTP_SERVER=smtp.gmail.com
SMTP_PORT=587
SMTP_USERNAME=your-email@gmail.com
SMTP_PASSWORD=your-app-password
SMTP_USE_TLS=true
MAIL_DEFAULT_SEND_FROM=your-email@gmail.com

For Gmail:

• Enable 2FA
• Generate App Password
• Use App Password as SMTP_PASSWORD

After config:

docker-compose restart api worker

We deploy Dify with human-in-the-loop workflows at Revolution AI — SMTP config is required for email delivery.