Upgrade OpenEvidence SDK versions and migrate between API versions.
Use when upgrading SDK, migrating to new API version,
or planning OpenEvidence version updates.
Trigger with phrases like "openevidence upgrade", "openevidence migrate",
"update openevidence sdk", "openevidence new version", "openevidence breaking changes".
OpenEvidence is a clinical AI platform that provides evidence-based medical answers and clinical decision support. The API exposes endpoints for clinical queries, evidence retrieval, and citation management. Tracking API changes is critical because OpenEvidence evolves its evidence grading schema, citation format, and clinical query response structure — and breaking changes in a healthcare context can surface outdated medical evidence, alter confidence scores, or remove critical safety disclaimers that downstream clinical applications depend on.
Version Detection
const OPENEVIDENCE_BASE = "https://api.openevidence.com/v1";
async function detectOpenEvidenceVersion(apiKey: string): Promise<void> {
const res = await fetch(`${OPENEVIDENCE_BASE}/status`, {
headers: { Authorization: `Bearer ${apiKey}`, "Content-Type": "application/json" },
});
const version = res.headers.get("x-openevidence-api-version") ?? "v1";
console.log(`OpenEvidence API version: ${version}`);
// Test clinical query response schema
const queryRes = await fetch(`${OPENEVIDENCE_BASE}/query`, {
method: "POST",
headers: { Authorization: `Bearer ${apiKey}`, "Content-Type": "application/json" },
body: JSON.stringify({ question: "What is the recommended treatment for hypertension?", max_citations: 1 }),
});
const data = await queryRes.json();
const hasStructuredCitations = data.citations?.[0]?.evidence_grade !== undefined;
console.log(`Structured citations: ${hasStructuredCitations}`);
const hasDisclaimers = data.disclaimers !== undefined;
console.log(`Disclaimers field present: ${hasDisclaimers}`);
}
Migration Checklist
Review OpenEvidence release notes for API schema changes
