Tiro.health Implementation Guide
0.1.0 - ci-build

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

OperationDefinition: Tiro Questionnaire $populate

Official URL: http://fhir.tiro.health/OperationDefinition/TiroPopulate Version: 0.1.0
Active as of 2026-04-30 Computable Name: TiroPopulate

Populate a Questionnaire with pre-existing data or AI-extracted values from clinical documents. Extends SDC Questionnaire/$populate with the contextual-populate mode and a provenance output parameter.

URL: [base]/Questionnaire/$populate

URL: [base]/Questionnaire/[id]/$populate

Parameters

UseNameScopeCardinalityTypeBindingDocumentation
INquestionnaire0..1canonical

Canonical URL (optionally versioned) of the Questionnaire to populate. If the operation is invoked on a Questionnaire instance, this parameter is optional.

INsubject0..1Reference

Patient resource or reference used as the population subject.

INmode0..1string

Population mode: pre-populate | re-populate | contextual-populate. Defaults to pre-populate.

INcontext0..*

Named context groups providing data for population. For contextual-populate, include a group with name='clinical-artifacts'.

INcontext.name1..1string

Context group name (e.g. 'clinical-artifacts').

INcontext.content0..*Reference

Content resource for this context group (e.g. a DocumentReference with an HTML or PDF attachment).

INresponseCandidate0..1QuestionnaireResponse

Existing QuestionnaireResponse used as the base for re-populate mode.

OUTresponse1..1QuestionnaireResponse

The populated QuestionnaireResponse.

OUTissues0..1OperationOutcome

Issues encountered during population (warnings, errors).

OUTprovenance0..*Provenance

One FormProvenance per populated field, describing how the value was obtained. Repeated — one entry per item. Each Provenance.target[0].extension[targetElement].valueUri points to the QuestionnaireResponse.item.id of the populated field.