Skip to main content
GET
/
form
/
human_input
/
{form_token}
Error
A valid request URL is required to generate request examples
{
  "form_content": "Please review the draft and confirm or request changes.",
  "inputs": [
    {
      "type": "text_input",
      "output_variable_name": "comment",
      "default": {
        "type": "constant",
        "selector": [],
        "value": ""
      }
    }
  ],
  "resolved_default_values": {
    "comment": ""
  },
  "user_actions": [
    {
      "id": "approve",
      "title": "Approve",
      "button_style": "primary"
    },
    {
      "id": "reject",
      "title": "Request changes",
      "button_style": "default"
    }
  ],
  "expiration_time": 1745510400
}

Documentation Index

Fetch the complete documentation index at: https://docs.dify.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

API Key authentication. For all API requests, include your API Key in the Authorization HTTP Header, prefixed with Bearer. Example: Authorization: Bearer {API_KEY}. Strongly recommend storing your API Key on the server-side, not shared or stored on the client-side, to avoid possible API-Key leakage that can lead to serious consequences.

Path Parameters

​
form_token
string
required

Access token for the paused form, returned in the human_input_required event from Run Workflow in streaming mode.

Response

Form contents retrieved successfully.

​
form_content
string

Pre-rendered form body with workflow variables substituted.

​
inputs
object[]

Form input field definitions.

​
resolved_default_values
object

Pre-filled default values, keyed by input output_variable_name. All values are stringified.

​
user_actions
object[]

Available submission actions.

​
expiration_time
integer<int64>

Unix timestamp (seconds) after which this form can no longer be submitted.