[DOCS]: File Upload API Behavior Mismatch with Documentation #243

New Issue

2026-02-16T05:19:32-05:00

yindo commented

2026-02-16 05:19:32 -05:00

Originally created by @lei-jia-xing on GitHub (Sep 22, 2025).

Type of Documentation Change

Content update

Documentation Page URL or Path

https://docs.dify.ai/api-reference/files/file-upload

Current Content

Current Content doesn't contain the preview_url while the actual api return preview_url

Suggested Changes

add preview_url description

Reason for Change

No response

Code of Conduct

I agree to follow Dify's documentation contribution guidelines
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.

Originally created by @lei-jia-xing on GitHub (Sep 22, 2025). ### Type of Documentation Change Content update ### Documentation Page URL or Path https://docs.dify.ai/api-reference/files/file-upload ### Current Content Current Content doesn't contain the preview_url while the actual api return preview_url ### Suggested Changes add preview_url description ### Reason for Change _No response_ ### Code of Conduct - [x] I agree to follow Dify's documentation [contribution guidelines](https://github.com/langgenius/dify/blob/0277a37fcad5ad86aeb239485c27fffd5cd90043/CONTRIBUTING.md) - [x] I have searched for existing issues [search for existing issues](https://github.com/langgenius/dify/issues), including closed ones. - [x] I confirm that I am using English to submit this report, otherwise it will be closed. - [x] 【中文用户 & Non English User】请使用英语提交，否则会被关闭：） - [x] Please do not modify this template :) and fill in all the required fields.

yindo added the documentation label 2026-02-16 05:19:32 -05:00

yindo closed this issue

2026-02-16 05:19:32 -05:00

yindo commented

2026-02-16 05:19:32 -05:00

@dosubot[bot] commented on GitHub (Oct 3, 2025):

Hi, @lei-jia-xing. I'm Dosu, and I'm helping the dify-docs team manage their backlog and am marking this issue as stale.

Issue Summary:

You reported that the File Upload API documentation is missing the description of the "preview_url" field.
The API does return this field, so you suggested updating the docs for accuracy.
There has been no further activity or comments on this issue since your report.
The issue remains unresolved.

Next Steps:

Please let me know if this issue is still relevant to the latest version of the dify-docs repository by commenting here.
If I do not hear back within 5 days, I will automatically close this issue.

Thank you for your understanding and contribution!

@dosubot[bot] commented on GitHub (Oct 3, 2025): Hi, @lei-jia-xing. I'm [Dosu](https://dosu.dev), and I'm helping the dify-docs team manage their backlog and am marking this issue as stale. **Issue Summary:** - You reported that the File Upload API documentation is missing the description of the "preview_url" field. - The API does return this field, so you suggested updating the docs for accuracy. - There has been no further activity or comments on this issue since your report. - The issue remains unresolved. **Next Steps:** - Please let me know if this issue is still relevant to the latest version of the dify-docs repository by commenting here. - If I do not hear back within 5 days, I will automatically close this issue. Thank you for your understanding and contribution!

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: langgenius/dify-docs#243