Skip to content

How to upload a custom Code System and a Value Set

There are two options for how to upload our own dictionary of coded values.: via the GitHub repository or API.

Upload CS and VS via API

  1. Prepare a file with a valid CS
  2. Upload it to the Kodjin FHIR Server by posting to {{host}}/terminology/CodeSystem
  3. Prepare a file with valid VS, referencing your CS
  4. Upload it by posting to {{host}}/terminology/ValueSet
  5. Wait several minutes until it is cached
  6. Check that everything works fine by calling an $expand operation on your ValueSet: {{host}}/terminology/ValueSet/{{vs_id}}/$expand

Upload CS and VS via the GitHub Repository

  1. Prepare a file with a valid CS and a file with a valid VS, referencing your CS
  2. Add CS to {{your_repository}}/terminology/custom/code_systems folder in your fixtures repository and VS to {{your_repository}}/terminology/custom/value_sets folder
  3. Push to the repository and wait several minutes until VS and CS are cashed
  4. Check that everything works fine by calling an $expand operation on your VS: {{host}}/terminology/ValueSet/{{vs_id}}/$expand