API Evangelist conversational phrasing for Elation Import patient chart import API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Elation Import patient chart import API
  version: 1.0.0
extends: openapi/elation-health-patient-chart-import-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 7
- target: $.paths['/data-import-requests/{dir-id}/patient-chart-imports'].get
  update:
    x-apievangelist-phrasing:
      intent: List chart imports by status
      effect: read
      questions:
      - Which patient chart imports in a data import request are still pending?
      - Can I filter chart imports by several statuses at once?
      instructions:
      - text: List chart imports in data import request {dir-id} with status {status}.
        slots:
          dir-id: path.dir-id
          status: query.status
      - text: Show every chart import under request {dir-id}.
        slots:
          dir-id: path.dir-id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/data-import-requests/{dir-id}/patient-chart-imports'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a patient chart to an import request
      effect: write
      questions:
      - How do I load a patient's chart JSON into a data import request?
      - Can I tag an imported chart with the patient id from the source system?
      instructions:
      - text: Add chart {chart_json} with status {status} to import request {dir-id}.
        slots:
          chart_json: requestBody.chart_json
          status: requestBody.status
          dir-id: path.dir-id
      - text: Import source patient {source_patient_id}'s chart into request {dir-id}.
        slots:
          source_patient_id: requestBody.source_patient_id
          dir-id: path.dir-id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/data-import-requests/{dir-id}/patient-chart-imports/{pci-id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one patient chart import
      effect: read
      questions:
      - How do I check the state of one chart import?
      - What does a single patient-chart-import record return?
      instructions:
      - text: Get chart import {pci-id} in request {dir-id}.
        slots:
          pci-id: path.pci-id
          dir-id: path.dir-id
      - text: Show the status of patient chart import {pci-id} under {dir-id}.
        slots:
          pci-id: path.pci-id
          dir-id: path.dir-id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/data-import-requests/{dir-id}/patient-chart-imports/{pci-id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace a patient chart import
      effect: write
      questions:
      - Can I resend the full chart JSON for an import that already exists?
      - How do I link an imported chart to an existing patient?
      instructions:
      - text: Replace chart import {pci-id} in request {dir-id} with chart {chart_json} and status {status}.
        slots:
          pci-id: path.pci-id
          dir-id: path.dir-id
          chart_json: requestBody.chart_json
          status: requestBody.status
      - text: Link chart import {pci-id} under {dir-id} to patient {patient_id}.
        slots:
          pci-id: path.pci-id
          dir-id: path.dir-id
          patient_id: requestBody.patient_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/data-import-requests/{dir-id}/patient-chart-imports/{pci-id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a patient chart import
      effect: destructive
      questions:
      - How do I drop a chart from a data import request?
      - Can a bad chart import be deleted before it is processed?
      instructions:
      - text: Delete chart import {pci-id} from request {dir-id}.
        slots:
          pci-id: path.pci-id
          dir-id: path.dir-id
      - text: Remove patient chart import {pci-id} under import request {dir-id}.
        slots:
          pci-id: path.pci-id
          dir-id: path.dir-id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/data-import-requests/{dir-id}/patient-chart-imports/{pci-id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Change a chart import's status with form data
      effect: write
      questions:
      - Can I update only the status of a chart import using form data?
      - How do I rename a chart import without resending its JSON?
      instructions:
      - text: Set the status of chart import {pci-id} in {dir-id} to {status}.
        slots:
          pci-id: path.pci-id
          dir-id: path.dir-id
          status: requestBody.status
      - text: Rename chart import {pci-id} under {dir-id} to {name}.
        slots:
          pci-id: path.pci-id
          dir-id: path.dir-id
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/data-import-requests/{dir-id}/patient-chart-imports/{pci-id}/render-requests'].post
  update:
    x-apievangelist-phrasing:
      intent: Upload a document for rendering
      effect: write
      questions:
      - How do I upload a document to be rendered as part of a chart import?
      - Can I attach extra metadata when uploading a file for rendering?
      instructions:
      - text: Upload {file} for rendering on chart import {pci-id} in request {dir-id}.
        slots:
          file: requestBody.file
          pci-id: path.pci-id
          dir-id: path.dir-id
      - text: Send a render request for chart import {pci-id} under {dir-id} with metadata {additionalMetadata}.
        slots:
          pci-id: path.pci-id
          dir-id: path.dir-id
          additionalMetadata: requestBody.additionalMetadata
      method: generated
      generated: '2026-09-26'