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