Huli FHIR Core Implementation Guide (R4)
0.1.0 - Release

Huli FHIR Core Implementation Guide (R4) - Local Development build (v0.1.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

OperationDefinition: Upload a DocumentReference binary

Official URL: https://fhir.huli.ai/r4/OperationDefinition/DocumentReference-upload Version: 0.1.0
Active as of 2026-09-11 Computable Name: DocumentReferenceUpload

Create a DocumentReference together with its binary in one request. Two intake modes are accepted: (1) an inline DocumentReference whose binary rides in content[0].attachment.data (base64); (2) a multipart/form-data body with a file part plus subject (Patient reference or id) and optional encounter, category, and reviewer fields. The uploaded document is routed to a practitioner for review: name them with author[0] (inline) or the reviewer form field (multipart) — a Practitioner reference in the caller's organization — defaulting to the organization owner when omitted. Returns the created DocumentReference; a subsequent read carries a time-limited signed download URL.

URL: [base]/DocumentReference/$upload

Parameters

UseNameScopeCardinalityTypeBindingDocumentation
INdocument1..1DocumentReference

The inline DocumentReference (base64 binary in content[0].attachment.data; optional author[0] names the reviewing practitioner). For the multipart mode the equivalent fields are supplied as form parts (file, subject, optional encounter/category/reviewer) instead of this resource.

OUTreturn1..1DocumentReference

The created DocumentReference.