How can HTTP request nodes pass attachments to the knowledge base through API

[tianshiqingge]

Self Checks

• This is only for bug report, if you would like to ask a question, please head to Discussions.
• I have searched for existing issues search for existing issues, including closed ones.
• I confirm that I am using English to submit this report (我已阅读并同意 Language Policy).
• [FOR CHINESE USERS] 请务必使用英文提交 Issue，否则会被关闭。谢谢！:)
• Please do not modify this template :) and fill in all the required fields.

Dify version

1.4.0

Cloud or Self Hosted

Self Hosted (Docker)

Steps to reproduce

In the workflow, I want to store the converted file of miners in the knowledge base through the "HTTP Request" node. When I use body json, the configuration is as follows: {"name": "ceshi. md",
"Text": "Analyze Content",
"indexing_technique": "economy",
"process_rule": {"mode": "automatic"}}
Error message: Failed to parse JSON: {"name": "text. md", "text": "

xtd>Cashier groupxtd>x/td>xtd>Annotation

Cashier group	SKTGROUP
Field Chinese name		Field English name	Field type		Is it a primary keyd>	Non empty:/td>std>Default value
Paycounter group ID	lD. If I use the form-data in the body to pass in the parsed file, I don't know how to configure the parameters or how to implement my functionality ✔️ Expected Behavior No response ❌ Actual Behavior No response

[dosubot]

To pass attachments (such as files) to the knowledge base using an HTTP request node in Dify, you should use the form-data body type. Here’s how you can set this up and what you need to know:

---

1. Use the Correct API Endpoint

To upload a document to a knowledge base (dataset), use the endpoint:

POST /v1/datasets/{dataset_id}/document/create-by-file

2. Set Headers

• Authorization: Bearer {api_key}
• Content-Type: multipart/form-data (this is set automatically when using form-data)

3. Configure the Body as Form-Data

You need to include:

• A file field containing the file to upload.
• A data field containing a JSON string with metadata (such as indexing_technique and process_rule).

Example cURL:

curl --location --request POST 'https://api.dify.ai/v1/datasets/{dataset_id}/document/create-by-file' \
--header 'Authorization: Bearer {api_key}' \
--form 'data="{\"indexing_technique\":\"economy\",\"process_rule\":{\"mode\":\"automatic\"}}";type=text/plain' \
--form 'file=@"path/to/your/file.md"'

Reference

---

4. Dify HTTP Request Node Configuration

In Dify’s workflow, configure the HTTP request node as follows:

• Method: POST
• URL: https://api.dify.ai/v1/datasets/{dataset_id}/document/create-by-file
• Headers: Add your Authorization header.
• Body Type: form-data
• Body Data:
  • Add a field with key file, type file, and select/upload your file.
  • Add a field with key data, type text, and value as your JSON string (e.g., {"indexing_technique":"economy","process_rule":{"mode":"automatic"}}).

The internal structure for form-data in Dify is handled by the BodyData class, which allows you to specify both file and text fields in the request body reference.

---

5. Known Limitations

• The HTTP request node in Dify has a known limitation: it does not support uploading files larger than 800KB. For larger files, use a Python code node instead of the HTTP request node reference.
• Always ensure your Content-Type is set to multipart/form-data and all required fields are included.

---

6. Example Node Configuration (Pseudocode)

{
  "method": "post",
  "url": "https://api.dify.ai/v1/datasets/{dataset_id}/document/create-by-file",
  "headers": {
    "Authorization": "Bearer {api_key}"
  },
  "body": {
    "type": "form-data",
    "data": [
      {
        "key": "file",
        "type": "file",
        "file": ["your_file_id", "file"]
      },
      {
        "key": "data",
        "type": "text",
        "value": "{\"indexing_technique\":\"economy\",\"process_rule\":{\"mode\":\"automatic\"}}"
      }
    ]
  }
}

See code example

---

If you encounter further issues, double-check your JSON formatting in the data field and ensure your file size is within the supported limit. For advanced scenarios or larger files, switch to a Python code node for more control.

To reply, just mention my name @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}   

[crazywoola]

This is only for bug report, if you would like to ask a question, please head to Discussions.