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": "paragraph",
      "output_variable_name": "feedback",
      "default": {
        "type": "constant",
        "selector": [],
        "value": ""
      }
    },
    {
      "type": "file-list",
      "output_variable_name": "attachments",
      "default": null,
      "allowed_file_types": [
        "document",
        "image"
      ],
      "allowed_file_extensions": [],
      "allowed_file_upload_methods": [
        "local_file",
        "remote_url"
      ],
      "number_limits": 5
    }
  ],
  "resolved_default_values": {
    "feedback": ""
  },
  "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://dify-6c0370d8-docs-hitl-2.mintlify.app/llms.txt

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

Authorizations

Authorization
string
header
required

API Key 認証です。すべての API リクエストにおいて、Authorization HTTP ヘッダーに Bearer プレフィックスを付けた API Key を含めてください。例:Authorization: Bearer {API_KEY}API Key はサーバーサイドに保存し、クライアントサイドで共有・保存しないことを強く推奨します。API Key の漏洩は深刻な結果につながる可能性があります。

Path Parameters

form_token
string
required

一時停止中のフォームへのアクセストークン。ストリーミングモードのワークフローを実行エンドポイントまたはチャットメッセージを送信エンドポイントが返す human_input_required イベントから取得します。

Response

フォーム内容の取得に成功しました。

form_content
string

ワークフロー変数を埋め込んだ、事前レンダリング済みのフォーム本文。

inputs
object[]

フォーム入力フィールドの定義。

resolved_default_values
object

フォームに表示するための事前計算済みデフォルト値。入力の output_variable_name をキーとします。デフォルト値がワークフロー変数から解決可能な paragraph 入力にのみ設定されます。解決可能なデフォルトがない入力では空になります。クライアントはこれらの値をそのまま表示してください。 default をクライアント側で再解決する必要はありません。すべての値は文字列化されています。

user_actions
object[]

利用可能な送信アクション。

expiration_time
integer<int64>

Unix タイムスタンプ(秒)。この時刻以降、フォームは送信できなくなります。