# 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 Lab Vendor Patient Sites API
  version: 1.0.0
extends: openapi/elation-health-lab-vendor-patient-sites-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: 12
- target: $.paths['/lab_vendor_patient_sites/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a lab patient service site (Get)
      effect: read
      questions:
      - How do I get the address of a lab's patient service site?
      - Can I get a lab draw site's fax number by id from the legacy endpoint?
      instructions:
      - text: Get lab vendor patient site {id}.
        slots:
          id: path.id
      - text: Get the phone and fax for lab draw site {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-02'
- target: $.paths['/lab_vendor_patient_sites/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Put a lab patient site (legacy)
      effect: write
      questions:
      - Can I overwrite a lab patient site with the older Put call?
      - Which field is required when putting a lab vendor patient site?
      instructions:
      - text: Put lab site {id} with name {name}.
        slots:
          id: path.id
          name: requestBody.name
      - text: 'Legacy-put lab site {id}: name {name}, city {city}, zip {zip}.'
        slots:
          id: path.id
          name: requestBody.name
          city: requestBody.city
          zip: requestBody.zip
      method: generated
      generated: '2026-09-26'
- target: $.paths['/lab_vendor_patient_sites/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a lab patient site (legacy)
      effect: destructive
      questions:
      - How do I delete a lab draw site with the legacy call?
      - Can I remove a lab patient site we created by mistake?
      instructions:
      - text: Delete lab site {id} with the legacy call.
        slots:
          id: path.id
      - text: Remove the mistaken lab draw location {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/lab_vendor_patient_sites/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Patch a lab patient site (legacy)
      effect: write
      questions:
      - Can I patch just a lab site's phone with the older Patch call?
      - Is there a legacy way to change a lab site's suite number?
      instructions:
      - text: Patch lab site {id} phone to {phone}.
        slots:
          id: path.id
          phone: requestBody.phone
      - text: Legacy-patch lab site {id} suite to {suite}.
        slots:
          id: path.id
          suite: requestBody.suite
      method: generated
      generated: '2026-09-26'
- target: $.paths['/lab_vendor_patient_sites/'].get
  update:
    x-apievangelist-phrasing:
      intent: Find lab patient sites by vendor
      effect: read
      questions:
      - Where can patients go for a lab draw from a given lab vendor?
      - Can I find the lab patient sites my practice uses?
      instructions:
      - text: Find lab patient sites for vendor {vendor}.
        slots:
          vendor: query.vendor
      - text: Find lab draw sites for practice {practice}.
        slots:
          practice: query.practice
      method: generated
      generated: '2026-09-26'
- target: $.paths['/lab_vendor_patient_sites/'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a lab patient site (legacy)
      effect: write
      questions:
      - How do I add a lab draw location for a vendor using the older create call?
      - What do I need to add a practice-created lab patient site?
      instructions:
      - text: Add lab site {name} for vendor {vendor}, practice-created {practice_created}.
        slots:
          name: requestBody.name
          vendor: requestBody.vendor
          practice_created: requestBody.practice_created
      - text: Legacy-create lab site {name} at {address} for vendor {vendor}, practice-created {practice_created}.
        slots:
          name: requestBody.name
          address: requestBody.address
          vendor: requestBody.vendor
          practice_created: requestBody.practice_created
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/lab_vendor_patient_sites/'].get
  update:
    x-apievangelist-phrasing:
      intent: List lab patient sites with paging
      effect: read
      questions:
      - Can I page through all lab vendor patient sites?
      - How do I list lab draw sites sorted by a field?
      instructions:
      - text: List lab vendor patient sites, {limit} per page.
        slots:
          limit: query.limit
      - text: List lab sites for vendor {vendor} ordered by {order_by}.
        slots:
          vendor: query.vendor
          order_by: query.order_by
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/lab_vendor_patient_sites/'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a lab patient site
      effect: write
      questions:
      - How do I create a new lab vendor patient site with just a name?
      - Can I create a lab site with a full address?
      instructions:
      - text: Create lab vendor patient site {name}.
        slots:
          name: requestBody.name
      - text: Create lab site {name} at {address}, {city} {state} {zip}.
        slots:
          name: requestBody.name
          address: requestBody.address
          city: requestBody.city
          state: requestBody.state
          zip: requestBody.zip
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/lab_vendor_patient_sites/{id}/'].get
  update:
    x-apievangelist-phrasing:
      intent: Retrieve a lab patient site
      effect: read
      questions:
      - Can I retrieve a single lab vendor patient site from the v2.0 API?
      - Does retrieving a lab site show when it was created?
      instructions:
      - text: Retrieve lab vendor patient site {id}.
        slots:
          id: path.id
      - text: Retrieve the created date of lab site {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-02'
- target: $.paths['/api/2.0/lab_vendor_patient_sites/{id}/'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace a lab patient site
      effect: write
      questions:
      - Can I replace a lab vendor patient site entirely?
      - What's required when replacing a lab site record?
      instructions:
      - text: Replace lab vendor patient site {id} with name {name}.
        slots:
          id: path.id
          name: requestBody.name
      - text: 'Replace lab site {id}: {name}, vendor {vendor}, fax {fax}.'
        slots:
          id: path.id
          name: requestBody.name
          vendor: requestBody.vendor
          fax: requestBody.fax
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/lab_vendor_patient_sites/{id}/'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a lab patient site
      effect: destructive
      questions:
      - How do I delete an existing lab vendor patient site?
      - Can I destroy a lab site record by id?
      instructions:
      - text: Delete existing lab vendor patient site {id}.
        slots:
          id: path.id
      - text: Destroy lab site record {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/lab_vendor_patient_sites/{id}/'].patch
  update:
    x-apievangelist-phrasing:
      intent: Partially update a lab patient site
      effect: write
      questions:
      - Can I partially update a lab site's city and state?
      - How do I rename a lab vendor patient site?
      instructions:
      - text: Rename lab vendor patient site {id} to {name}.
        slots:
          id: path.id
          name: requestBody.name
      - text: Partially update lab site {id} city to {city}.
        slots:
          id: path.id
          city: requestBody.city
      method: generated
      generated: '2026-09-26'