openevidence-common-errors

# OpenEvidence Common Errors ## Overview OpenEvidence provides AI-powered clinical decision support through evidence-based query answering with citation tracking. API integrations involve submitting clinical questions, retrieving evidence summaries, and managing citation references. Common errors include overly broad queries that exceed processing limits, citation-not-found errors when referenced studies are retracted, and timeouts on complex multi-condition queries that trigger deep literature analysis. The DeepConsult mode provides more thorough analysis but consumes 5x the rate limit quota and has a 90-second timeout. This reference covers authentication, query validation, and clinical-specific error patterns. ## Error Reference | Code | Message | Cause | Fix | |------|---------|-------|-----| | `401` | `Authentication failed` | Invalid or expired API key | Regenerate at OpenEvidence developer portal | | `403` | `Organization access denied` | API key not authorized for org | Verify org ID matches the key's assigned organization | | `404` | `Citation not found` | Referenced study retracted or removed | Query for updated evidence; citation database refreshes weekly | | `408` | `Query timeout` | Complex multi-condition query exceeded 90s limit | Simplify query to single clinical question; avoid compound conditions | | `422` | `Query too broad` | Question not specific enough for clinical analysis | Add condition, population, or intervention to narrow scope | | `422` | `Non...