Error Reference
Every error the system produces includes an error code (e.g. ERR_AI_AUTH_INVALID) displayed in the user-facing message. This directory contains a detailed runbook for each error code.
How to Use
When a user reports an error, find the error code in their message and look up the corresponding document below for root cause analysis and resolution steps.
Error Codes
AI / LLM Errors
| Code | Name | Retryable | Doc |
|---|---|---|---|
ERR_AI_AUTH_INVALID | AI Authentication Failed | No | ai-auth-invalid.md |
ERR_AI_RATE_LIMITED | AI Rate Limited | Yes | ai-rate-limited.md |
ERR_AI_OVERLOADED | AI Overloaded | Yes | ai-overloaded.md |
ERR_AI_CONTEXT_TOO_LONG | AI Context Too Long | No | ai-context-too-long.md |
ERR_AI_PERMISSION_DENIED | AI Permission Denied | No | ai-permission-denied.md |
External Service Errors
| Code | Name | Retryable | Doc |
|---|---|---|---|
ERR_MARKER_SUBMIT_FAILED | Marker Submission Failed | Yes | marker-submit-failed.md |
ERR_MARKER_TIMEOUT | Marker Timeout | Yes | marker-timeout.md |
ERR_MARKER_API_KEY_INVALID | Marker API Key Invalid | No | marker-api-key-invalid.md |
ERR_MATHPIX_SUBMIT_FAILED | Mathpix Submission Failed | Yes | mathpix-submit-failed.md |
ERR_MATHPIX_TIMEOUT | Mathpix Timeout | Yes | mathpix-timeout.md |
ERR_EMAIL_SEND_FAILED | Email Send Failed | Yes | email-send-failed.md |
ERR_STRIPE_ERROR | Stripe Error | Yes | stripe-error.md |
ERR_STRIPE_INVALID_SIGNATURE | Stripe Invalid Signature | No | stripe-invalid-signature.md |
Storage Errors
| Code | Name | Retryable | Doc |
|---|---|---|---|
ERR_STORAGE_READ_FAILED | Storage Read Failed | Yes | storage-read-failed.md |
ERR_STORAGE_WRITE_FAILED | Storage Write Failed | Yes | storage-write-failed.md |
ERR_KV_READ_FAILED | KV Read Failed | Yes | kv-read-failed.md |
ERR_KV_WRITE_FAILED | KV Write Failed | Yes | kv-write-failed.md |
Database Errors
| Code | Name | Retryable | Doc |
|---|---|---|---|
ERR_DB_CONNECTION_FAILED | Database Connection Failed | Yes | db-connection-failed.md |
ERR_DB_QUERY_FAILED | Database Query Failed | Yes | db-query-failed.md |
ERR_CREDITS_DEDUCTION_FAILED | Credit Deduction Failed | Yes | credits-deduction-failed.md |
ERR_CREDITS_INSUFFICIENT | Insufficient Credits | No | credits-insufficient.md |
Authentication Errors
| Code | Name | Retryable | Doc |
|---|---|---|---|
ERR_AUTH_TOKEN_MISSING | Auth Token Missing | No | auth-token-missing.md |
ERR_AUTH_TOKEN_EXPIRED | Auth Token Expired | No | auth-token-expired.md |
ERR_AUTH_JWKS_FETCH_FAILED | Auth JWKS Fetch Failed | Yes | auth-jwks-fetch-failed.md |
PDF Processing Errors
| Code | Name | Retryable | Doc |
|---|---|---|---|
ERR_PDF_CORRUPT | PDF Corrupt | No | pdf-corrupt.md |
ERR_PDF_PASSWORD_PROTECTED | PDF Password Protected | No | pdf-password-protected.md |
ERR_PDF_TOO_LARGE | PDF Too Large | No | pdf-too-large.md |
ERR_CONVERSION_TIMEOUT | Conversion Timeout | Yes | conversion-timeout.md |
ERR_CONVERSION_EMPTY_OUTPUT | Conversion Empty Output | Yes | conversion-empty-output.md |
Network Errors
| Code | Name | Retryable | Doc |
|---|---|---|---|
ERR_NETWORK_OFFLINE | Network Offline | Yes | network-offline.md |
ERR_NETWORK_TIMEOUT | Network Timeout | Yes | network-timeout.md |
ERR_SERVER_UNAVAILABLE | Server Unavailable | Yes | server-unavailable.md |
URL Fetch Errors
| Code | Name | Retryable | Doc |
|---|---|---|---|
ERR_URL_SSRF_BLOCKED | URL SSRF Blocked | No | url-ssrf-blocked.md |
ERR_URL_TIMEOUT | URL Timeout | Yes | url-timeout.md |
ERR_URL_FETCH_FAILED | URL Fetch Failed | Yes | url-fetch-failed.md |
ERR_URL_NOT_PDF | URL Not PDF | No | url-not-pdf.md |