---
title: "Get Human Input Form"
method: GET
path: "/form/human_input/{form_token}"
tags: ["Human Input"]
---

# Get Human Input Form

`GET /form/human_input/{form_token}`

**Available for**: Chatflow, Workflow apps.

Returns the contents of a paused Human Input form. Requires web app delivery.

For the full sequence of Human Input calls, see [Human Input Flow](/en/api-reference/guides/human-input-flow).

## Path parameters

- `form_token` string, required

## Response `200`

Form contents retrieved successfully.

- object
  - `form_content` string — Pre-rendered form body with workflow variables substituted.
  - `inputs` object[] — Form input field definitions.
    - `type` string — Form input control type. Available values: `paragraph` (multi-line text input), `select` (single-choice from a list), `file` (single file upload), and `file-list` (multiple file uploads).
    - `output_variable_name` string — Variable name used to reference this input's submitted value inside the workflow. Corresponds to the key in the submission `inputs` object.
    - `default` object, nullable — Raw default-value configuration for `paragraph` inputs. The client should not resolve this directly; use `resolved_default_values` to display defaults. absent for other input types or when no default is configured.
      - `type` string — Source of the default. `constant` means `value` is used as a literal string; `variable` means `selector` points to a workflow variable.
      - `selector` string[] — Variable reference path (for example, `["node_id", "var_name"]`) when `type` is `variable`. Must contain at least two elements.
      - `value` string — Literal default value when `type` is `constant`. Always a string.
    - `option_source` object — Source of options for `select` inputs. Present only when `type` is `select`.
      - `type` 'variable' | 'constant' — Origin of the options. `constant` means `value` lists the options literally; `variable` means `selector` points to an `array[string]` workflow variable that provides them.
      - `selector` string[] — Variable reference path when `type` is `variable`.
      - `value` string[] — Literal option list when `type` is `constant`.
    - `allowed_file_types` string[] — File categories the recipient may upload. Present for `file` and `file-list` inputs. Values: `image`, `document`, `audio`, `video`, `custom`.
    - `allowed_file_extensions` string[] — Allowed file extensions when `allowed_file_types` includes `custom`. Include the leading `.` in each extension, for example `.md`. Present for `file` and `file-list` inputs.
    - `allowed_file_upload_methods` string[] — Upload methods the recipient may use. Values: `local_file`, `remote_url`. Present for `file` and `file-list` inputs.
    - `number_limits` integer — Maximum number of files the recipient may upload. Present only for `file-list` inputs.
  - `resolved_default_values` object — Pre-rendered values to display in the form. Keyed by input `output_variable_name`. Populated for `paragraph` inputs whose default resolves from a workflow variable; empty for inputs with no resolvable default. Display these values; do not re-resolve `default` on the client. All values are stringified.
  - `user_actions` object[] — Available submission actions.
    - `id` string — Identifier of the action button. Pass as `action` on [Submit Human Input Form](/en/api-reference/human-input/submit-human-input-form) when the recipient selects this button.
    - `title` string — Button label shown to the recipient.
    - `button_style` string — Visual style of the button. Available values: `primary`, `default`, `accent`, `ghost`.
  - `expiration_time` integer, nullable — Unix timestamp (seconds) after which this form can no longer be submitted.

## Other responses

- `404` — `not_found` : Form not found.
- `412` — - `human_input_form_submitted` : Form already submitted. Forms are one-shot; the first response wins regardless of which user submits it. - `human_input_form_expired` : The form's expiration time passed before submission arrived.

---

[API](https://skmtc.net/langgenius/apis/dify-service-api.md) · [All operations](https://skmtc.net/langgenius/apis/dify-service-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/langgenius/dify-service-api/revisions/e49b3db72bad/schema)