Consume the CDS Hooks feedback endpoint to track clinician override reasons and improve hook card quality over time

domain: hl7.org/fhir/us/davinci-crd · 5 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Expose a POST /cds-services/{id}/feedback endpoint that accepts the feedback body with card UUID, outcome (accepted, overridden, ignored), and optional overrideReasons
  2. Persist feedback records linked to the original hook request hookInstance for audit and analytics
  3. Parse the overrideReasons array to identify coded reasons (e.g., patient-declined, alternative-treatment) for quality improvement analysis
  4. Aggregate feedback metrics to compute card acceptance rate per hook type and tune alert thresholds accordingly
  5. Return HTTP 200 with an empty body on successful receipt; return 400 only for malformed payloads

Known gotchas

Related routes

Implement a CDS Hooks service that responds to order-select and order-sign hooks from an EHR to provide real-time clinical decision support cards with suggestions and links
hl7.org/fhir · 5 steps · unrated
Implement a CDS Hooks patient-view service that uses a prefetch template to retrieve Observation resources without a server-side FHIR call and returns a gap-in-care card when a required screening is overdue
cds-hooks.org · 6 steps · unrated
Implement a CDS Hooks patient-view service that fires when a patient chart opens, returns information cards with relevant gap-in-care alerts, and handles the prefetch template to avoid extra server round-trips
hl7.org/fhir/us/davinci-crd · 6 steps · unrated

Give your agent this knowledge — and 15,600+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans