# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Settings Allergy Documentation API
  version: 1.0.0
extends: openapi/elation-health-allergy-documentation-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: 4
- target: $.paths['/allergy_documentation/'].get
  update:
    x-apievangelist-phrasing:
      intent: Find no-known-drug-allergy records
      effect: read
      questions:
      - Has this patient been documented as having no known drug allergies?
      - Can I list the NKDA documentation on file for a patient?
      instructions:
      - text: Find NKDA documentation for patient {patient}.
        slots:
          patient: query.patient
      - text: List every no-known-drug-allergy record on file.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/allergy_documentation/'].post
  update:
    x-apievangelist-phrasing:
      intent: Document no known drug allergies
      effect: write
      questions:
      - How do I record that a patient has no known drug allergies?
      - Can I mark NKDA on a chart so allergy review counts as done?
      instructions:
      - text: Document NKDA for patient {patient}.
        slots:
          patient: requestBody.patient
      - text: Mark patient {patient} as having no known drug allergies.
        slots:
          patient: requestBody.patient
      method: generated
      generated: '2026-09-26'
- target: $.paths['/allergy_documentation/{allergy_documentation_id}/'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an NKDA documentation record
      effect: read
      questions:
      - What does a single NKDA documentation record contain?
      - When was no-known-drug-allergy status recorded on this entry?
      instructions:
      - text: Get NKDA documentation {allergy_documentation_id}.
        slots:
          allergy_documentation_id: path.allergy_documentation_id
      - text: Show allergy documentation record {allergy_documentation_id}.
        slots:
          allergy_documentation_id: path.allergy_documentation_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/allergy_documentation/{allergy_documentation_id}/'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove an NKDA documentation record
      effect: destructive
      questions:
      - Can I remove an NKDA entry after the patient reports a drug allergy?
      - What's the way to undo no-known-drug-allergy documentation recorded in error?
      instructions:
      - text: Delete NKDA documentation {allergy_documentation_id}.
        slots:
          allergy_documentation_id: path.allergy_documentation_id
      - text: Remove the no-known-drug-allergy record {allergy_documentation_id} from the chart.
        slots:
          allergy_documentation_id: path.allergy_documentation_id
      method: generated
      generated: '2026-09-26'