2025-08-27 Call Notes REST API

Tags

@Sebastian Iancu

todo: reviewing

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

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

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

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

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

• also https://github.com/openEHR/specifications-ITS-REST/pull/118 added to SPECITS-77

notes:

• SPECITS-50

  • make return=identifier default, deprecate default as return=minimal- need ask feedback from EHRbase also

  • recommend to make this configurable as a flag on the CDR side - but this flag is not a hard requirement

  • use singular “unique identifier” not “identifiers”

• SPECITS-74

  • question if we should deprecate the Location header also from Update and Delete

    • what do we get when as response on a GET on the version that is deleted?

    • remove it (deprecated) from delete

Template Id impact on REST API

@Former user (Deleted) @Sebastian Iancu @Severin Kohler

• proposals:

  • for GET template that the template_id is considered to be a reference, giving partial id will resolve to “latest” major version of that template (“archetype reference rules applies”)

  • for upload on adl2 deprecate the version query parameter

  • in list-template the version property should be “synced” with the version identifier from template_id; should be “null” if the version-id is not specified

  • align ADL2 with ADL1.4 on template_id as reference, deprecate ADL2 “Get template at version”

Template admin

https://openehr.atlassian.net/browse/SPECITS-43

need folders endpoint

@Diego Bosca

 Composition

@Ian McNicoll

composition version_history endpoint (similar to https://build.fhir.org/http.html#history )

decouple from SM specs

@Sebastian Iancu