2026-01-14 Call Notes REST API

Tags

@Sebastian Iancu

todo: reviewing

• https://openehr.atlassian.net/browse/SPECITS-77

• https://openehr.atlassian.net/browse/SPECITS-58

• https://openehr.atlassian.net/browse/SPECITS-34

• https://openehr.atlassian.net/browse/SPECITS-61

• https://openehr.atlassian.net/browse/SPECITS-46

todo:

• https://openehr.atlassian.net/browse/SPECITS-86

notes:

• list https://{baseUrl}/v1/definition/template/adl1.4/?pattern=&versions=

  • pattern applied to more templates (not only template_id), e.g. pattern={template_id=vital*;template_hrid=*;concept=*signs*}

    • see https://www.w3.org/DesignIssues/MatrixURIs.html

  • versions=all|latest, default latest

• get https://{baseUrl}/v1/definition/template/adl1.4/{template_id} most recent if template_id is HRID or uses semantic version

• https://openehr.atlassian.net/browse/SPECITS-84

  • preference toward supporting flatting header but it will be only to the composition inside the data, the rest of the contribution remains canonical

  • investigate if we can fully flatten the whole contribution, how would it look like

  • @Ian McNicoll this is the way it is supported in Better:

    • "action": "CREATE",

              "ehrId": "{{ehrId}}",

              "format": "FLAT",

              "templateId": "OL - Care plan management",

              "composition": {

       

      {{ehrscapeBaseUrl}}/composition/contribution?committerName=Restart App&committerId=12345&comment=CMC Data Migration

       

• check before releasing if this is solved: https://discourse.openehr.org/t/referring-to-the-enclosing-composition-from-action-instruction-details/5516/12?u=erik.sundvall see https://discourse.openehr.org/t/referring-to-the-enclosing-composition-from-action-instruction-details/5516

• propose addition to create-ehr to support optional subjectId and subjectNamespace query parameter without ehr_status payload; perhaps a id format that encapsulate a namespace-id, something that the system can map to internally known namespaces) => ask on discourse?