# 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 Historical Medication Download Requests API
  version: 1.0.0
extends: openapi/elation-health-historical-medication-download-requests-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: 3
- target: $.paths['/api/2.0/medication_history_downloads/'].get
  update:
    x-apievangelist-phrasing:
      intent: List medication history downloads
      effect: read
      questions:
      - What medication history downloads have been requested?
      - Can I page through past medication history requests?
      instructions:
      - text: List medication history downloads.
      - text: Show medication history downloads ordered by {order_by}.
        slots:
          order_by: query.order_by
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/medication_history_downloads/'].post
  update:
    x-apievangelist-phrasing:
      intent: Request a patient's medication history
      effect: write
      questions:
      - How do I pull a patient's external medication history?
      - Can I limit a medication history download to a date range?
      instructions:
      - text: Request medication history for patient {patient} in practice {practice}.
        slots:
          patient: requestBody.patient
          practice: requestBody.practice
      - text: Download patient {patient}'s medication history from {from} until {until} for practice {practice}.
        slots:
          patient: requestBody.patient
          from: requestBody.from_date
          until: requestBody.until_date
          practice: requestBody.practice
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/medication_history_downloads/{id}/'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a medication history download
      effect: read
      questions:
      - Did a medication history download succeed, and how many items came back?
      - What error did a medication history request return?
      instructions:
      - text: Get medication history download {id}.
        slots:
          id: path.id
      - text: Show the result and error code of history download {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'