Skip to main content
POST
/
form
/
human_input
/
files
/
remote-upload
Error
A valid request URL is required to generate request examples
{
  "id": "1a77f0df-c0e6-461c-987c-e72526f341ee",
  "name": "report.pdf",
  "size": 204800,
  "extension": "pdf",
  "url": "https://files.example.com/signed/report.pdf?sig=abc123",
  "mime_type": "application/pdf",
  "created_by": "f1e2d3c4-b5a6-7890-abcd-ef1234567890",
  "created_at": 1705407629
}

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

用于向人工介入表单附加文件的短期上传令牌。通过 签发上传令牌 接口获取，并以 Authorization: Bearer hitl_upload_{token} 形式传入。

Body

application/json
​
url
string<uri>
required

可公开访问的文件 URL，用于拉取并附加。

Response

远程文件拉取并附加成功。

​
id
string

在 提交人工介入表单 接口的 file 和 file-list 输入中，将该值作为 upload_file_id 引用。

​
name
string

从远程 URL 或响应头派生的文件名。

​
size
integer

文件大小（字节）。

​
extension
string | null

文件扩展名。

​
url
string | null

用于获取文件内容的签名 URL。

​
mime_type
string | null

文件的 MIME 类型。

​
created_by
string | null

文件归属的用户标识。

​
created_at
integer<int64> | null

文件创建时的 Unix 时间戳（秒）。