How to fix Attachment Preview Issues in BoldDesk Tickets
Attachment preview issues in BoldDesk Tickets are most commonly caused by an incorrect Content‑Type specified during file uploads using the BoldDesk REST API. BoldDesk relies on this metadata to determine whether an attachment can be previewed directly in the ticket view.
This article explains why attachment previews fail and how to ensure files uploaded to tickets render correctly.
What Causes the Issue
When uploading files through the API, the system relies on the Content-Type header to identify the file format. If this header is incorrect or missing, the preview functionality may not work as expected.
For example: The appropriate Content-Type for a PDF file is application/pdf, whereas application/json or other unrelated types are incorrect.
How to Fix It
To ensure attachments preview correctly:
- Always set the appropriate Content-Type based on the file type.
- Confirm that your API request includes the correct header.
Example for PDF Upload - Content-Type: application/pdf
You may refer to the extension and type listed below.
| Extension | MIME Type |
|---|---|
| application/pdf | |
| .json | application/json |
| .jpg/.jpeg | image/jpeg |
| .png | image/png |
| .csv | text/csv |
| .txt | text/plain |
FAQs
-
Can BoldDesk fix an incorrect Content‑Type after the file is uploaded?
No. BoldDesk uses the MIME sent at upload time. Re-upload the file with the correct Content‑Type to enable preview. -
Do file extensions alone control the preview?
No. BoldDesk primarily relies on the Content‑Type header from the upload request. The extension helps, but a wrong MIME type can still break previews. -
Does BoldDesk support preview for all file types?
No. Only previewable formats (e.g., PDF, common images, text/CSV) render inline. Others can still be uploaded and downloaded. -
Can I retrieve a ticket attachment using the BoldDesk REST API?
Yes. Using the Get Ticket Attachments API, BoldDesk returns attachment details along with a secure fileURL and attachment token. This fileURL can be used to download the attachment directly, and it does not require user login through the BoldDesk UI.
