Error Codes

{
  "detail": "Error message describing what went wrong"
}

{
  "detail": [
    {
      "type": "validation_error",
      "loc": ["body", "field_name"],
      "msg": "Field validation message",
      "input": "provided_value"
    }
  ]
}

from datalab_sdk import DatalabClient
from datalab_sdk.exceptions import (
    DatalabAPIError,
    DatalabTimeoutError,
    DatalabFileError,
    DatalabValidationError,
)

client = DatalabClient()

try:
    result = client.convert("document.pdf")
except DatalabFileError as e:
    print(f"File issue: {e}")
except DatalabTimeoutError as e:
    print(f"Timed out: {e}")
except DatalabAPIError as e:
    print(f"API error (HTTP {e.status_code}): {e}")
    if e.response_data:
        print(f"Details: {e.response_data}")

{"detail": "Invalid file type. Only PDF files, word documents, spreadsheets, powerpoints, HTML, and PNG, JPG, GIF, TIFF, and WEBP images are accepted."}

{"detail": "File size exceeds upload limit of 209715200 bytes."}

{"detail": "Invalid API key provided. Set the X-API-Key header to your API key."}

{"detail": "You need an active, paid subscription to use this API."}

{"detail": "Your subscription has expired. You may need to re-enable your plan, or pay an unpaid invoice."}

{"detail": "Your payment has failed. Please pay any unpaid invoices to continue using the API."}

{"detail": "Rate limit exceeded for endpoint /api/v1/convert. You can make 200 requests every 60 seconds. Please try again later, or reach out to support@datalab.to if you need a higher limit."}

{"detail": "Concurrency exceeded for endpoint /api/v1/convert. You can have 400 concurrent requests running at once. Please try again later, or reach out to support@datalab.to if you need a higher limit."}

{"success": false, "error": "Page rate limit exceeded. Your team has {current_pages} pages in flight and this request adds {page_count} more ({total} total, limit: 5,000). Please wait for some requests to complete before submitting more, or contact support@datalab.to for a higher limit."}