DoclingDocling for IBM watsonx

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-Key header

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_position in 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.

For more help, consult the FAQ page or contact the support team.

On this page