{"schema":"debriefmd.connector-requirements","version":1,"platform":"medhub","tenant":"","evidence":[],"requirements":[{"id":"tenant","title":"Tenant and owner","detail":"Exact tenant URL, institution, program scope, platform/version, named technical owner and sandbox."},{"id":"authorization","title":"Authorized access","detail":"Supported scoped grant or service account, secret-store reference, rotation/revocation and denied cross-program tests. Never collect an institutional password."},{"id":"workflow","title":"Supported destination workflow","detail":"Vendor/admin confirmation of the exact write operation or completed-assessment importer, template/schema, size limits and sandbox example. Roster, schedule or grade imports are different workflows."},{"id":"identity","title":"Identity and authorship","detail":"Stable resident, assessor, program and academic-year mappings. Record DebriefMD as drafter and retain the real completing actor; never impersonate a preceptor."},{"id":"mapping","title":"Versioned field mapping","detail":"Frozen source form ID/definition hash and destination form/version/question IDs. Map every field and rating option explicitly; record unmapped items and preserve attribution, blanks and multi-note structure."},{"id":"approval","title":"Exact reviewed revision","detail":"Bind resident release to the submitted content hash. Changes invalidate approval. Confirm any destination-required assessor approval separately."},{"id":"privacy","title":"Data and residency approval","detail":"Approved destination/processing locations, minimum payload, retention/deletion and institutional agreement. No audio, transcript, self-reflection or model evidence in the handoff."},{"id":"delivery","title":"Delivery and reconciliation","detail":"Idempotency key, timeouts/rate limits, retry policy, destination record ID and read-back receipt. A download or HTTP 200 alone is not official filing."},{"id":"corrections","title":"Corrections and rollback","detail":"Define draft/final states, locked-record amendments, duplicate handling, revocation and reconciliation; do not assume a submitted evaluation can be edited or deleted."},{"id":"acceptance","title":"Tenant acceptance evidence","detail":"Synthetic end-to-end filing approved by program/admin: exact fields, authorship, receipt, denied foreign access, duplicate retry and correction. Record versions and dated evidence."}],"research":{"id":"medhub","name":"MedHub","api":"The vendor documents API-based integration. Its myTIPreport guide demonstrates a configured completed-evaluation publishing integration.","fileImport":"That integration uses a dedicated locked form and linked identities. It is a partner precedent, not an open CSV/XLSX import contract for DebriefMD.","nextStep":"Request partner API access and a named integration form. Agree on identity mappings, immutable submission/correction rules and delivery receipts.","sources":[{"label":"MedHub integration overview","url":"https://www.medhub.com/software/"},{"label":"myTIPreport evaluation publishing","url":"https://mytipreport.org/guides/v1/medhub-evaluations"}]},"researchedOn":"2026-10-22","notice":"Discovery checklist only. Contains no credentials or assessment data. Completeness does not enable a connector or certify vendor compatibility."}