# 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 Tests API
  version: 1.0.0
extends: openapi/elation-health-lab-order-tests-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: 8
- target: $.paths['/lab_order_tests/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up an orderable lab test (legacy)
      effect: read
      questions:
      - Can I pull one orderable lab test by id from the older unversioned endpoint?
      - What does the legacy lab order tests path return for a single test?
      instructions:
      - text: Fetch legacy lab order test {id}.
        slots:
          id: path.id
      - text: Open orderable lab test {id} from the original route.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/lab_order_tests/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an orderable lab test (legacy)
      effect: destructive
      questions:
      - Can I remove a practice-created lab test with the unversioned API?
      - Which old call deletes a lab order test?
      instructions:
      - text: Delete legacy lab order test {id}.
        slots:
          id: path.id
      - text: Remove orderable test {id} via the original route.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/lab_order_tests/'].get
  update:
    x-apievangelist-phrasing:
      intent: Search orderable lab tests (legacy)
      effect: read
      questions:
      - Can I look up a lab test by its code on the legacy path?
      - Does the old test search filter by lab vendor and compendium?
      instructions:
      - text: Find legacy lab tests with code {code}.
        slots:
          code: query.code
      - text: Search old-route tests from lab vendor {lab_vendor} in compendium {compendium}.
        slots:
          lab_vendor: query.lab_vendor
          compendium: query.compendium
      method: generated
      generated: '2026-09-26'
- target: $.paths['/lab_order_tests/'].post
  update:
    x-apievangelist-phrasing:
      intent: Add an orderable lab test (legacy)
      effect: write
      questions:
      - What must I send to add a lab test through the legacy endpoint?
      - Can the old create call include CPT codes and ask-at-order questions?
      instructions:
      - text: Create legacy lab test {name} with code {code} for lab vendor {lab_vendor} in compendium {compendium}.
        slots:
          name: requestBody.name
          code: requestBody.code
          lab_vendor: requestBody.lab_vendor
          compendium: requestBody.compendium
      - text: Add old-route test {name} with CPTs {cpts} and synonyms {synonyms}.
        slots:
          name: requestBody.name
          cpts: requestBody.cpts
          synonyms: requestBody.synonyms
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/lab_order_tests/'].get
  update:
    x-apievangelist-phrasing:
      intent: List orderable lab tests
      effect: read
      questions:
      - How do I see which lab tests a vendor offers?
      - Can I search v2.0 lab tests by name and only show practice-created ones?
      instructions:
      - text: List v2.0 lab tests named {name}.
        slots:
          name: query.name
      - text: Show tests created by practice {practice} where practice-created is {practice_created}.
        slots:
          practice: query.practice
          practice_created: query.practice_created
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/lab_order_tests/'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an orderable lab test
      effect: write
      questions:
      - Is only a name required to create a lab test in API v2.0?
      - Can I set a procedure class on a new lab test?
      instructions:
      - text: Create v2.0 lab test {name}.
        slots:
          name: requestBody.name
      - text: Add test {name} with procedure class {procedure_class} and code {code}.
        slots:
          name: requestBody.name
          procedure_class: requestBody.procedure_class
          code: requestBody.code
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/lab_order_tests/{id}/'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one orderable lab test
      effect: read
      questions:
      - What does a single v2.0 lab test record include?
      - Which CPT codes and questions come with a lab test?
      instructions:
      - text: Retrieve v2.0 lab test {id}.
        slots:
          id: path.id
      - text: Show the CPTs and questions on lab test {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/lab_order_tests/{id}/'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an orderable lab test
      effect: destructive
      questions:
      - Can I delete a lab test from the catalog in API v2.0?
      - What removes a lab order test in the current API?
      instructions:
      - text: Delete v2.0 lab test {id}.
        slots:
          id: path.id
      - text: Take lab test {id} out of the orderable catalog.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'