Human Input
Get Human Input Form
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.
GET
/
form
/
human_input
/
{form_token}
Get Human Input Form
curl --request GET \
--url https://{api_base_url}/form/human_input/{form_token} \
--header 'Authorization: Bearer <token>'import requests
url = "https://{api_base_url}/form/human_input/{form_token}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://{api_base_url}/form/human_input/{form_token}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://{api_base_url}/form/human_input/{form_token}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://{api_base_url}/form/human_input/{form_token}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://{api_base_url}/form/human_input/{form_token}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://{api_base_url}/form/human_input/{form_token}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"expiration_time": 1745510400,
"form_content": "Please review the draft, set a priority, and confirm or request changes.",
"inputs": [
{
"default": {
"selector": [],
"type": "constant",
"value": ""
},
"output_variable_name": "feedback",
"type": "paragraph"
},
{
"option_source": {
"selector": [],
"type": "constant",
"value": [
"low",
"medium",
"high"
]
},
"output_variable_name": "priority",
"type": "select"
},
{
"allowed_file_extensions": [],
"allowed_file_types": [
"image",
"document"
],
"allowed_file_upload_methods": [
"local_file",
"remote_url"
],
"output_variable_name": "attachment",
"type": "file"
},
{
"allowed_file_extensions": [],
"allowed_file_types": [
"image",
"document"
],
"allowed_file_upload_methods": [
"local_file",
"remote_url"
],
"number_limits": 5,
"output_variable_name": "attachments",
"type": "file-list"
}
],
"resolved_default_values": {
"feedback": ""
},
"user_actions": [
{
"button_style": "primary",
"id": "approve",
"title": "Approve"
},
{
"button_style": "default",
"id": "reject",
"title": "Request changes"
}
]
}
Authorizations
Every request authenticates with an API key: Authorization: Bearer {API_KEY}. App endpoints take an app API key; knowledge endpoints take a knowledge base API key (Get Started).
Keep keys server-side; never embed them in client code. Requests with a missing or invalid key fail with HTTP 401 (unauthorized).
Path Parameters
Access token for the paused form, returned in the human_input_required event from the Run Workflow or Send Chat Message endpoint in streaming mode.
Response
Form contents retrieved successfully.
Unix timestamp (seconds) after which this form can no longer be submitted.
Pre-rendered form body with workflow variables substituted.
Form input field definitions.
Show child attributes
Show child attributes
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.
Show child attributes
Show child attributes
Available submission actions.
Show child attributes
Show child attributes
Last modified on September 30, 2026
Was this page helpful?
⌘I
Get Human Input Form
curl --request GET \
--url https://{api_base_url}/form/human_input/{form_token} \
--header 'Authorization: Bearer <token>'import requests
url = "https://{api_base_url}/form/human_input/{form_token}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://{api_base_url}/form/human_input/{form_token}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://{api_base_url}/form/human_input/{form_token}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://{api_base_url}/form/human_input/{form_token}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://{api_base_url}/form/human_input/{form_token}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://{api_base_url}/form/human_input/{form_token}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"expiration_time": 1745510400,
"form_content": "Please review the draft, set a priority, and confirm or request changes.",
"inputs": [
{
"default": {
"selector": [],
"type": "constant",
"value": ""
},
"output_variable_name": "feedback",
"type": "paragraph"
},
{
"option_source": {
"selector": [],
"type": "constant",
"value": [
"low",
"medium",
"high"
]
},
"output_variable_name": "priority",
"type": "select"
},
{
"allowed_file_extensions": [],
"allowed_file_types": [
"image",
"document"
],
"allowed_file_upload_methods": [
"local_file",
"remote_url"
],
"output_variable_name": "attachment",
"type": "file"
},
{
"allowed_file_extensions": [],
"allowed_file_types": [
"image",
"document"
],
"allowed_file_upload_methods": [
"local_file",
"remote_url"
],
"number_limits": 5,
"output_variable_name": "attachments",
"type": "file-list"
}
],
"resolved_default_values": {
"feedback": ""
},
"user_actions": [
{
"button_style": "primary",
"id": "approve",
"title": "Approve"
},
{
"button_style": "default",
"id": "reject",
"title": "Request changes"
}
]
}