# 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 Sleep Order Tests API
  version: 1.0.0
extends: openapi/elation-health-sleep-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: 7
- target: $.paths['/sleep_order_tests/'].get
  update:
    x-apievangelist-phrasing:
      intent: Find sleep study tests (legacy endpoint)
      effect: read
      questions:
      - Which sleep study tests can my practice order, per the legacy lookup?
      - Can I search sleep order tests by name with the older endpoint?
      instructions:
      - text: Using the legacy lookup, find sleep order tests named {name}.
        slots:
          name: query.name
      - text: Find old-path sleep tests available to practice {practice}.
        slots:
          practice: query.practice
      method: generated
      generated: '2026-09-26'
- target: $.paths['/sleep_order_tests/'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a sleep study test (legacy endpoint)
      effect: write
      questions:
      - How do I add a custom sleep study test to my practice's list via the legacy endpoint?
      - Can I give a sleep order test a code when creating it the old way?
      instructions:
      - text: Via the legacy endpoint, add sleep test {name} for practice {practice}.
        slots:
          name: requestBody.name
          practice: requestBody.practice
      - text: Create an old-path sleep order test {name} with code {code} at practice {practice}.
        slots:
          name: requestBody.name
          code: requestBody.code
          practice: requestBody.practice
      method: generated
      generated: '2026-09-26'
- target: $.paths['/sleep_order_tests/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a sleep study test (legacy endpoint)
      effect: read
      questions:
      - Can I look up one sleep order test on the legacy path?
      - Does the older lookup return a sleep test's code?
      instructions:
      - text: Open sleep order test {id} using the legacy endpoint.
        slots:
          id: path.id
      - text: Show the name and code of old-path sleep test {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/sleep_order_tests/'].get
  update:
    x-apievangelist-phrasing:
      intent: List sleep order tests in API 2.0
      effect: read
      questions:
      - How do I list the sleep order tests in the 2.0 API?
      - Can API 2.0 filter sleep tests by practice and sort them?
      instructions:
      - text: List 2.0 sleep order tests for practice {practice} ordered by {order_by}.
        slots:
          practice: query.practice
          order_by: query.order_by
      - text: List API 2.0 sleep tests matching name {name}, {limit} per page.
        slots:
          name: query.name
          limit: query.limit
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/sleep_order_tests/'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a sleep order test in API 2.0
      effect: write
      questions:
      - How do I create a new sleep order test with the 2.0 API?
      - Is a practice required when defining a sleep study test?
      instructions:
      - text: In API 2.0, create sleep order test {name} for practice {practice}.
        slots:
          name: requestBody.name
          practice: requestBody.practice
      - text: Define a 2.0 sleep study test {name} coded {code} at practice {practice}.
        slots:
          name: requestBody.name
          code: requestBody.code
          practice: requestBody.practice
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/sleep_order_tests/{id}/'].get
  update:
    x-apievangelist-phrasing:
      intent: Retrieve a sleep order test in API 2.0
      effect: read
      questions:
      - How do I retrieve a single sleep order test by ID in API 2.0?
      - Does a 2.0 sleep test show which practice it belongs to?
      instructions:
      - text: Retrieve API 2.0 sleep order test {id}.
        slots:
          id: path.id
      - text: Get the practice and code of 2.0 sleep test {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/sleep_order_tests/{id}/'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a sleep order test in API 2.0
      effect: destructive
      questions:
      - How do I delete a sleep order test in the 2.0 API?
      - Can I remove a sleep study test my practice no longer orders?
      instructions:
      - text: Delete API 2.0 sleep order test {id}.
        slots:
          id: path.id
      - text: Remove unused 2.0 sleep study test {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'