# 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 Pulmonary Order Tests API
  version: 1.0.0
extends: openapi/elation-health-pulmonary-order-tests-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: 7
- target: $.paths['/pulmonary_order_tests/'].get
  update:
    x-apievangelist-phrasing:
      intent: Find pulmonary tests by name
      effect: read
      questions:
      - Which pulmonary tests, like spirometry, can my practice order?
      - Can I find a pulmonary order test by name?
      instructions:
      - text: Find pulmonary order tests named {name}.
        slots:
          name: query.name
      - text: Find pulmonary tests set up for practice {practice}.
        slots:
          practice: query.practice
      method: generated
      generated: '2026-09-26'
- target: $.paths['/pulmonary_order_tests/'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a pulmonary test (legacy)
      effect: write
      questions:
      - How do I add an orderable pulmonary test with the older create?
      - Can I give a pulmonary test a code when adding it?
      instructions:
      - text: Add legacy pulmonary test {name} for practice {practice}.
        slots:
          name: requestBody.name
          practice: requestBody.practice
      - text: Legacy-add pulmonary test {name} with code {code} to {practice}.
        slots:
          name: requestBody.name
          code: requestBody.code
          practice: requestBody.practice
      method: generated
      generated: '2026-10-02'
- target: $.paths['/pulmonary_order_tests/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a pulmonary test type (Get)
      effect: read
      questions:
      - How do I get an orderable pulmonary test by id?
      - Can I get the code of a pulmonary test?
      instructions:
      - text: Get pulmonary order test {id}.
        slots:
          id: path.id
      - text: Get the code of pulmonary test {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/pulmonary_order_tests/'].get
  update:
    x-apievangelist-phrasing:
      intent: List pulmonary tests with paging
      effect: read
      questions:
      - Can I page through all pulmonary order tests?
      - How do I list pulmonary tests sorted by name?
      instructions:
      - text: List pulmonary order tests, {limit} per page.
        slots:
          limit: query.limit
      - text: List pulmonary tests for {practice} ordered by {order_by}.
        slots:
          practice: query.practice
          order_by: query.order_by
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/pulmonary_order_tests/'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a pulmonary order test
      effect: write
      questions:
      - What's needed to create a new pulmonary order test?
      - Can I create a pulmonary test type for my practice?
      instructions:
      - text: Create v2.0 pulmonary order test {name} in practice {practice}.
        slots:
          name: requestBody.name
          practice: requestBody.practice
      - text: Create pulmonary test {name}, code {code}, practice {practice}.
        slots:
          name: requestBody.name
          code: requestBody.code
          practice: requestBody.practice
      method: generated
      generated: '2026-10-02'
- target: $.paths['/api/2.0/pulmonary_order_tests/{id}/'].get
  update:
    x-apievangelist-phrasing:
      intent: Retrieve a pulmonary order test
      effect: read
      questions:
      - Can I retrieve a single pulmonary order test?
      - Where do I retrieve when a pulmonary test was created?
      instructions:
      - text: Retrieve pulmonary order test {id}.
        slots:
          id: path.id
      - text: Retrieve the created date of pulmonary test {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/pulmonary_order_tests/{id}/'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a pulmonary order test
      effect: destructive
      questions:
      - How do I delete a pulmonary order test?
      - Can I remove a pulmonary test type we no longer order?
      instructions:
      - text: Delete pulmonary order test {id}.
        slots:
          id: path.id
      - text: Remove unused pulmonary test {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'