Skip to main content
POST
/
form
/
human_input
/
{form_token}
Error
A valid request URL is required to generate request examples
{}

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.

Body

application/json
inputs
object
required

Recipient-supplied values keyed by input output_variable_name.

action
string
required

ID of the action button the recipient selected. Must match one of the id values from the form's user_actions list (returned by Get Human Input Form).

Maximum string length: 20
Pattern: ^[A-Za-z_][A-Za-z0-9_]*$
user
string
required

End-user identifier for the submitter.

Response

Form submitted successfully. The response body is an empty object.

The response is of type object.