dify - 💡(How to fix) Fix After embedding the WebApp into a third-party system, clicking the referenced documents in the conversation window throws an error [1 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
langgenius/dify#35719Fetched 2026-05-01 05:53:32
View on GitHub
Comments
0
Participants
1
Timeline
2
Reactions
1
Author
Participants
Timeline (top)
labeled ×2

Error Message

After embedding the WebApp into a third-party system, clicking the referenced documents returned in the conversation window triggers an error.Troubleshooting confirmed the issue is caused by no permission when calling the knowledge base download API.However, there is no configuration entry in the embedded WebApp to set the API key for this interface。 An error occurs upon clicking, preventing the content from loading.

Root Cause

After embedding the WebApp into a third-party system, clicking the referenced documents returned in the conversation window triggers an error.Troubleshooting confirmed the issue is caused by no permission when calling the knowledge base download API.However, there is no configuration entry in the embedded WebApp to set the API key for this interface。

RAW_BUFFERClick to expand / collapse

Self Checks

  • I have read the Contributing Guide and Language Policy.
  • 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, otherwise it will be closed.
  • 【中文用户 & Non English User】请使用英语提交,否则会被关闭 :)
  • Please do not modify this template :) and fill in all the required fields.

Dify version

1.13.3

Cloud or Self Hosted

Self Hosted (Docker)

Steps to reproduce

After embedding the WebApp into a third-party system, clicking the referenced documents returned in the conversation window triggers an error.Troubleshooting confirmed the issue is caused by no permission when calling the knowledge base download API.However, there is no configuration entry in the embedded WebApp to set the API key for this interface。

<img width="615" height="1158" alt="Image" src="https://github.com/user-attachments/assets/d1796a97-e16a-48c1-9ac1-1f3efe67e747" /> <img width="1266" height="978" alt="Image" src="https://github.com/user-attachments/assets/bab4353e-7df2-45fe-9786-12aa3023ee50" /> <img width="2235" height="576" alt="Image" src="https://github.com/user-attachments/assets/cd3c2afe-16e5-412d-b73f-62d503e48281" /> <img width="962" height="810" alt="Image" src="https://github.com/user-attachments/assets/90085ec8-9ec0-453d-87ee-3754623425c3" />

✔️ Expected Behavior

Clicking on the referenced document lets you open it directly or download it.

❌ Actual Behavior

An error occurs upon clicking, preventing the content from loading.

extent analysis

TL;DR

The issue can be resolved by configuring the API key for the knowledge base download API in the embedded WebApp.

Guidance

  • The error occurs due to a missing API key configuration for the knowledge base download API, which is required for permission.
  • To fix this, you need to add a configuration entry in the embedded WebApp to set the API key for this interface.
  • Check the Dify documentation for version 1.13.3 to see if there are any existing configuration options or workarounds for setting the API key.
  • If no configuration option is available, consider reaching out to the Dify support team or community for further assistance.

Notes

The provided images do not contain any relevant information for troubleshooting the issue, and the problem seems to be related to the configuration of the embedded WebApp.

Recommendation

Apply workaround: Add a configuration entry in the embedded WebApp to set the API key for the knowledge base download API, if possible, or reach out to the Dify support team for further assistance.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING