# 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 Bills API
  version: 1.0.0
extends: openapi/elation-health-bills-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: 11
- target: $.paths['/bills/{id}/'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up a bill (legacy endpoint)
      effect: read
      questions:
      - How do I fetch one bill from the legacy unversioned bills path?
      - What does the old bills endpoint return for a single bill?
      instructions:
      - text: Fetch legacy bill {id}.
        slots:
          id: path.id
      - text: Show bill {id} using the original bills endpoint.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bills/{id}/'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a bill (legacy draft endpoint)
      effect: destructive
      questions:
      - Can I delete a bill through the legacy bills API?
      - Is the legacy bill delete endpoint finished or still a draft?
      instructions:
      - text: Delete legacy bill {id}.
        slots:
          id: path.id
      - text: Remove bill {id} through the old bills endpoint.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bills/{id}/'].patch
  update:
    x-apievangelist-phrasing:
      intent: Edit a bill (legacy PATCH)
      effect: write
      questions:
      - Can I record a billing error on a bill with the legacy PATCH?
      - What legacy call updates a bill's CPT codes and providers?
      instructions:
      - text: Patch legacy bill {id} with CPT codes {cpts}.
        slots:
          id: path.id
          cpts: requestBody.cpts
      - text: Log billing error {billing_error} on old-style bill {id}.
        slots:
          billing_error: requestBody.billing_error
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bills/'].get
  update:
    x-apievangelist-phrasing:
      intent: Find bills by patient or service date (legacy)
      effect: read
      questions:
      - How can I search the legacy bills endpoint by service date range?
      - Can the old bill finder return the bill for one visit note?
      instructions:
      - text: Find legacy bills for patient {patient} serviced between {from_service_date} and {to_service_date}.
        slots:
          patient: query.patient
          from_service_date: query.from_service_date
          to_service_date: query.to_service_date
      - text: Search old-style bills for visit note {visit_note_id}.
        slots:
          visit_note_id: query.visit_note_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bills/'].post
  update:
    x-apievangelist-phrasing:
      intent: Bill a visit note (legacy endpoint)
      effect: write
      questions:
      - How do I create a bill for a visit note through the legacy API?
      - Which fields does the old endpoint require to bill a visit?
      instructions:
      - text: Create a legacy bill for visit note {visit_note} for patient {patient} with physician {physician} at {service_location}.
        slots:
          visit_note: requestBody.visit_note
          patient: requestBody.patient
          physician: requestBody.physician
          service_location: requestBody.service_location
      - text: Bill old-style visit note {visit_note} at practice {practice} with payment amount {payment_amount}.
        slots:
          visit_note: requestBody.visit_note
          practice: requestBody.practice
          payment_amount: requestBody.payment_amount
      method: generated
      generated: '2026-09-26'
- target: $.paths['/bills/{id}/actions/release-to-pms/'].patch
  update:
    x-apievangelist-phrasing:
      intent: Release a bill to the PMS (legacy)
      effect: write
      questions:
      - How do I push a bill to my practice management system with the legacy endpoint?
      - Is there an old unversioned route for sending a bill to PMS?
      instructions:
      - text: Release legacy bill {id} to the PMS.
        slots:
          id: path.id
      - text: Use the old endpoint to send bill {id} to the practice management system.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/bills/'].get
  update:
    x-apievangelist-phrasing:
      intent: List bills
      effect: read
      questions:
      - Which bills were created for a patient in Elation?
      - Can I filter bills by signing or assigned physician?
      - Is there a way to list bills within a service date window?
      instructions:
      - text: List bills for patient {patient} from {from_service_date} to {to_service_date}.
        slots:
          patient: query.patient
          from_service_date: query.from_service_date
          to_service_date: query.to_service_date
      - text: Show bills signed by physician {signing_physician} at practice {practice}.
        slots:
          signing_physician: query.signing_physician
          practice: query.practice
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/bills/'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a bill for a visit
      effect: write
      questions:
      - How do I create a bill with CPT codes for a visit in v2?
      - Can a new v2 bill include prior authorization and a referring provider?
      instructions:
      - text: Create a bill for visit note {visit_note} with CPT codes {cpts} for patient {patient}.
        slots:
          visit_note: requestBody.visit_note
          cpts: requestBody.cpts
          patient: requestBody.patient
      - text: Bill v2 visit note {visit_note} with prior authorization {prior_authorization} and referring provider {referring_provider}.
        slots:
          visit_note: requestBody.visit_note
          prior_authorization: requestBody.prior_authorization
          referring_provider: requestBody.referring_provider
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/bills/{id}/'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one bill
      effect: read
      questions:
      - How do I see the CPT codes and payment on one bill?
      - What does a v2 bill record contain?
      instructions:
      - text: Get bill {id}.
        slots:
          id: path.id
      - text: Retrieve v2 bill {id} with its charges.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/bills/{id}/'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a bill's details
      effect: write
      questions:
      - Can I change the place of service on an existing bill?
      - How do I add a reference number to a v2 bill?
      instructions:
      - text: Set the place of service on bill {id} to {place_of_service}.
        slots:
          id: path.id
          place_of_service: requestBody.place_of_service
      - text: Add reference number {ref_number} to v2 bill {id}.
        slots:
          ref_number: requestBody.ref_number
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/bills/{id}/actions/release-to-pms/'].patch
  update:
    x-apievangelist-phrasing:
      intent: Send a bill to the connected PMS
      effect: write
      questions:
      - Can I do the same as the Send to PMS button on the Billing Report through the API?
      - What v2 call releases a bill to my connected practice management system?
      instructions:
      - text: Send bill {id} to our connected PMS.
        slots:
          id: path.id
      - text: Release v2 bill {id} to practice management.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'