Troubleshooting
Common issues and solutions for Docling for IBM watsonx
Troubleshooting
I am getting an "Invalid API Key" error
- Verify your API Key is correct
- Check that you're using the
X-Api-Keyheader
My conversion has failed
- Check the error message in the status response
- Verify your document format is supported
- Ensure the document is not corrupted
My conversion is stuck in "pending"
Possible reasons:
- High system load - Check
task_positionin status response - Large document - Complex documents take longer
- Network issues - Verify connectivity to the service
If your request is at the top of the queue and taking longer than 5 minutes, contact support with the task_id.
I am getting a "Task result not found" error
This means:
- Conversion is still in progress (check status first)
- Task has expired (results are kept for 24 hours)
- Invalid
task_id(verify you're using the correct ID)
Always check the status endpoint before retrieving results.
I am observing low quality in the output
Possible causes and solutions:
- Low-resolution source - Use higher quality scans (300+ DPI)
- Unsupported format - Verify file format is supported
- Corrupted file - Test if your file opens in native application
If issues persist, contact support with sample documents.