# 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 Order Sets API
  version: 1.0.0
extends: openapi/elation-health-lab-order-sets-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: 12
- target: $.paths['/lab_order_sets/'].get
  update:
    x-apievangelist-phrasing:
      intent: Find lab order sets (legacy)
      effect: read
      questions:
      - How do I see the practice's saved lab order sets on the older endpoint?
      - Which legacy call lists our reusable lab panels?
      instructions:
      - text: Find all lab order sets using the legacy route.
      - text: Show the older list of saved lab panels for my practice.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/lab_order_sets/'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a lab order set (legacy)
      effect: write
      questions:
      - How do I save a reusable group of lab tests through the unversioned route?
      - Can I tie a legacy lab order set to a specific lab vendor?
      instructions:
      - text: Create a legacy lab order set {name} for practice {practice} with tests {content}.
        slots:
          name: requestBody.name
          practice: requestBody.practice
          content: requestBody.content
      - text: Save an older-style lab panel {name} sent to vendor {lab_vendor}.
        slots:
          name: requestBody.name
          lab_vendor: requestBody.lab_vendor
      method: generated
      generated: '2026-09-26'
- target: $.paths['/lab_order_sets/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one lab order set (legacy)
      effect: read
      questions:
      - How do I see which tests are in one saved lab set via the older route?
      - What does a single legacy lab order set contain?
      instructions:
      - text: Get legacy lab order set {id}.
        slots:
          id: path.id
      - text: Show the tests inside older lab panel {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/lab_order_sets/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace a lab order set (legacy)
      effect: write
      questions:
      - How do I overwrite a saved lab set's tests on the unversioned PUT route?
      - What must I resend when replacing a legacy lab order set?
      instructions:
      - text: Replace legacy lab order set {id} with name {name}, practice {practice} and tests {content}.
        slots:
          id: path.id
          name: requestBody.name
          practice: requestBody.practice
          content: requestBody.content
      - text: Overwrite older lab panel {id} and switch its vendor to {lab_vendor}.
        slots:
          id: path.id
          lab_vendor: requestBody.lab_vendor
      method: generated
      generated: '2026-09-26'
- target: $.paths['/lab_order_sets/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a lab order set (legacy)
      effect: destructive
      questions:
      - How do I remove a saved lab panel with the older delete call?
      - Which unversioned endpoint deletes a lab order set?
      instructions:
      - text: Delete legacy lab order set {id}.
        slots:
          id: path.id
      - text: Remove old lab panel {id} via the unversioned route.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/lab_order_sets/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Patch a lab order set (legacy)
      effect: write
      questions:
      - Can I rename a lab set and adjust its tests on the older PATCH route?
      - Which legacy call edits a lab panel without requiring the practice?
      instructions:
      - text: Patch legacy lab order set {id} to name {name} with tests {content}.
        slots:
          id: path.id
          name: requestBody.name
          content: requestBody.content
      - text: Edit older lab panel {id} in place using a PATCH.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/lab_order_sets/'].get
  update:
    x-apievangelist-phrasing:
      intent: List lab order sets with paging
      effect: read
      questions:
      - How do I page through lab order sets in the v2.0 API?
      - Can I sort the v2.0 lab order sets list?
      instructions:
      - text: List v2.0 lab order sets, {limit} per page.
        slots:
          limit: query.limit
      - text: Page through /api/2.0 lab panels from offset {offset} ordered by {order_by}.
        slots:
          offset: query.offset
          order_by: query.order_by
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/lab_order_sets/'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a lab order set in the v2.0 API
      effect: write
      questions:
      - Can I create a v2.0 lab order set with a lab compendium code?
      - What does /api/2.0 require to save a new lab panel?
      instructions:
      - text: Create v2.0 lab order set {name} for practice {practice} with tests {content} and compendium code {compendium_code}.
        slots:
          name: requestBody.name
          practice: requestBody.practice
          content: requestBody.content
          compendium_code: requestBody.compendium_code
      - text: Add an /api/2.0 lab panel {name} routed to vendor {lab_vendor}.
        slots:
          name: requestBody.name
          lab_vendor: requestBody.lab_vendor
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/lab_order_sets/{id}/'].get
  update:
    x-apievangelist-phrasing:
      intent: Retrieve a lab order set from the v2.0 API
      effect: read
      questions:
      - How do I fetch one lab order set by ID from /api/2.0?
      - Does the v2.0 lab set record include its compendium code?
      instructions:
      - text: Retrieve v2.0 lab order set {id}.
        slots:
          id: path.id
      - text: Show /api/2.0 lab panel {id} with its vendor and compendium code.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/lab_order_sets/{id}/'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace a lab order set in the v2.0 API
      effect: write
      questions:
      - How do I fully replace a lab order set through /api/2.0?
      - Which v2.0 call overwrites every field on a lab panel?
      instructions:
      - text: Replace v2.0 lab order set {id} with name {name}, practice {practice} and tests {content}.
        slots:
          id: path.id
          name: requestBody.name
          practice: requestBody.practice
          content: requestBody.content
      - text: Overwrite /api/2.0 lab panel {id}, setting compendium code {compendium_code}.
        slots:
          id: path.id
          compendium_code: requestBody.compendium_code
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/lab_order_sets/{id}/'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a lab order set in the v2.0 API
      effect: destructive
      questions:
      - How do I delete a lab order set with /api/2.0?
      - Can I retire an unused lab panel through the v2.0 API?
      instructions:
      - text: Delete v2.0 lab order set {id}.
        slots:
          id: path.id
      - text: Retire lab panel {id} from /api/2.0.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/lab_order_sets/{id}/'].patch
  update:
    x-apievangelist-phrasing:
      intent: Partially update a lab order set in v2.0
      effect: write
      questions:
      - Can I change only the lab vendor on a v2.0 lab order set?
      - How do I edit one field of an /api/2.0 lab panel?
      instructions:
      - text: Switch v2.0 lab order set {id} to vendor {lab_vendor}.
        slots:
          id: path.id
          lab_vendor: requestBody.lab_vendor
      - text: Update only the compendium code on /api/2.0 lab panel {id} to {compendium_code}.
        slots:
          id: path.id
          compendium_code: requestBody.compendium_code
      method: generated
      generated: '2026-09-26'