# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Elation Health Drug Intolerances API
  version: 1.0.0
extends: openapi/elation-health-drug-intolerances-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: 9
- target: $.paths['/drug_intolerances/'].get
  update:
    x-apievangelist-phrasing:
      intent: Find drug intolerances for patients
      effect: read
      questions:
      - What drug intolerances are recorded for a set of patients?
      - Can I look up medication intolerances across several patients at once?
      instructions:
      - text: Find drug intolerances for patients {patients}.
        slots:
          patients: query.patients
      - text: Find every recorded medication intolerance.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/drug_intolerances/{id}/'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a drug intolerance (Get)
      effect: read
      questions:
      - How do I get a single drug intolerance with its reaction?
      - Can I get the severity of a recorded intolerance by id?
      instructions:
      - text: Get drug intolerance {id}.
        slots:
          id: path.id
      - text: Get the reaction noted on intolerance {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/drug_intolerances/{id}/'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a drug intolerance (legacy)
      effect: destructive
      questions:
      - How do I delete a drug intolerance with the older delete call?
      - Can I remove an intolerance recorded by mistake?
      instructions:
      - text: Delete drug intolerance {id} with the legacy call.
        slots:
          id: path.id
      - text: Remove the mistaken intolerance entry {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/drug_intolerances/'].get
  update:
    x-apievangelist-phrasing:
      intent: List a patient's drug intolerances
      effect: read
      questions:
      - Can I page through one patient's drug intolerances?
      - How do I list intolerances sorted by start date?
      instructions:
      - text: List drug intolerances for patient {patient}.
        slots:
          patient: query.patient
      - text: List intolerances, {limit} per page, ordered by {order_by}.
        slots:
          limit: query.limit
          order_by: query.order_by
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/drug_intolerances/'].post
  update:
    x-apievangelist-phrasing:
      intent: Record a drug intolerance
      effect: write
      questions:
      - How do I record that a patient can't tolerate a medication?
      - Can I note the reaction and severity when adding an intolerance?
      instructions:
      - text: Record intolerance to {name} for patient {patient}.
        slots:
          name: requestBody.name
          patient: requestBody.patient
      - text: Add intolerance {name} for {patient} with reaction {reaction} and severity {severity}.
        slots:
          name: requestBody.name
          patient: requestBody.patient
          reaction: requestBody.reaction
          severity: requestBody.severity
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/drug_intolerances/{id}/'].get
  update:
    x-apievangelist-phrasing:
      intent: Retrieve a drug intolerance
      effect: read
      questions:
      - Can I retrieve a drug intolerance and its status?
      - Where do I retrieve when an intolerance started?
      instructions:
      - text: Retrieve drug intolerance {id}.
        slots:
          id: path.id
      - text: Retrieve the start date of intolerance {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/drug_intolerances/{id}/'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace a drug intolerance
      effect: write
      questions:
      - Can I replace a drug intolerance record entirely?
      - Which fields are required to overwrite an intolerance?
      instructions:
      - text: Replace intolerance {id} with drug {name} for patient {patient}.
        slots:
          id: path.id
          name: requestBody.name
          patient: requestBody.patient
      - text: 'Overwrite intolerance {id}: {name}, {patient}, status {status}.'
        slots:
          id: path.id
          name: requestBody.name
          patient: requestBody.patient
          status: requestBody.status
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/drug_intolerances/{id}/'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a drug intolerance
      effect: destructive
      questions:
      - How do I delete an existing drug intolerance by id?
      - Can a drug intolerance be destroyed?
      instructions:
      - text: Delete existing drug intolerance {id}.
        slots:
          id: path.id
      - text: Destroy intolerance record {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/drug_intolerances/{id}/'].patch
  update:
    x-apievangelist-phrasing:
      intent: Partially update a drug intolerance
      effect: write
      questions:
      - Can I change only the severity of an intolerance?
      - How do I mark an intolerance inactive without resending it?
      instructions:
      - text: Set severity of intolerance {id} to {severity}.
        slots:
          id: path.id
          severity: requestBody.severity
      - text: Change status of intolerance {id} to {status}.
        slots:
          id: path.id
          status: requestBody.status
      method: generated
      generated: '2026-09-26'