# 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 Pharmacies API
  version: 1.0.0
extends: openapi/elation-health-pharmacies-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-02'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 4
- target: $.paths['/pharmacies/{ncpdpid}/'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up a pharmacy by NCPDP id (legacy)
      effect: read
      questions:
      - How do I look up a pharmacy by its NCPDP id on the legacy endpoint?
      - What does the unversioned endpoint for pharmacies return for one pharmacy?
      instructions:
      - text: Fetch legacy pharmacy {ncpdpid}.
        slots:
          ncpdpid: path.ncpdpid
      - text: Show pharmacy with NCPDP id {ncpdpid} from the original endpoint.
        slots:
          ncpdpid: path.ncpdpid
      method: generated
      generated: '2026-10-02'
- target: $.paths['/pharmacies/'].get
  update:
    x-apievangelist-phrasing:
      intent: Find pharmacies by active window (WIP)
      effect: read
      questions:
      - Is there a work-in-progress pharmacy search by active time on the legacy endpoint?
      - Can the WIP pharmacy finder show pharmacies active in a time window?
      instructions:
      - text: Find WIP pharmacies active between {active_start_time} and {active_end_time}.
        slots:
          active_start_time: query.active_start_time
          active_end_time: query.active_end_time
      - text: Run the draft pharmacy search from {active_start_time}.
        slots:
          active_start_time: query.active_start_time
      method: generated
      generated: '2026-10-02'
- target: $.paths['/api/2.0/pharmacies/'].get
  update:
    x-apievangelist-phrasing:
      intent: List pharmacies
      effect: read
      questions:
      - Which pharmacies can I send prescriptions to in Elation?
      - Can I list pharmacies that were active during a given period in the v2.0 API?
      instructions:
      - text: List pharmacies active from {active_start_time} to {active_end_time}.
        slots:
          active_start_time: query.active_start_time
          active_end_time: query.active_end_time
      - text: Show v2 pharmacies ordered by {order_by}.
        slots:
          order_by: query.order_by
      method: generated
      generated: '2026-10-02'
- target: $.paths['/api/2.0/pharmacies/{ncpdpid}/'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one pharmacy
      effect: read
      questions:
      - How do I get a pharmacy's details by NCPDP id in v2?
      - What does a v2 pharmacy record include?
      instructions:
      - text: Get v2.0 pharmacy {ncpdpid}.
        slots:
          ncpdpid: path.ncpdpid
      - text: Retrieve v2 pharmacy with NCPDP {ncpdpid}.
        slots:
          ncpdpid: path.ncpdpid
      method: generated
      generated: '2026-10-02'