# 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 Billing Codes API
  version: 1.0.0
extends: openapi/elation-health-billing-codes-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: 10
- target: $.paths['/billing_codes/'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a CPT billing code (legacy)
      effect: write
      questions:
      - How do I add a CPT code my practice can put on bills?
      - Can I set a default charge when adding a billing code with the older call?
      instructions:
      - text: Add CPT code {code} to practice {practice}.
        slots:
          code: requestBody.code
          practice: requestBody.practice
      - text: Legacy-add CPT code {code} for practice {practice} charging {charge}.
        slots:
          code: requestBody.code
          practice: requestBody.practice
          charge: requestBody.charge
      method: generated
      generated: '2026-09-26'
- target: $.paths['/billing_codes/{billing_code_id}/'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a CPT billing code (Get)
      effect: read
      questions:
      - How do I get one CPT code my practice set up?
      - Can I get a billing code's charge by id?
      instructions:
      - text: Get billing code {billing_code_id}.
        slots:
          billing_code_id: path.billing_code_id
      - text: Get the charge on CPT code record {billing_code_id}.
        slots:
          billing_code_id: path.billing_code_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/billing_codes/ (COPY)'].get
  update:
    x-apievangelist-phrasing:
      intent: Search a practice's CPT codes
      effect: read
      questions:
      - Which CPT codes has my practice configured for billing, per the legacy unversioned endpoint?
      - Can I search billing codes by description text?
      instructions:
      - text: Get the billing codes for practice {practice}.
        slots:
          practice: query.practice
      - text: Search billing codes with description {description}.
        slots:
          description: query.description
      method: generated
      generated: '2026-10-02'
- target: $.paths['/billing_codes/{billing_code_id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a CPT billing code (legacy)
      effect: write
      questions:
      - Can I change the charge on a CPT code with the older update call?
      - How do I reorder a billing code in the practice list?
      instructions:
      - text: Legacy-update billing code {billing_code_id} charge to {charge}.
        slots:
          billing_code_id: path.billing_code_id
          charge: requestBody.charge
      - text: Move billing code {billing_code_id} to sequence {sequence}.
        slots:
          billing_code_id: path.billing_code_id
          sequence: requestBody.sequence
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/billing_codes/'].get
  update:
    x-apievangelist-phrasing:
      intent: List CPT billing codes with paging
      effect: read
      questions:
      - Can I page through all billing codes with limit and offset?
      - How do I list CPT codes sorted by sequence in the v2.0 API?
      instructions:
      - text: List billing codes, {limit} per page.
        slots:
          limit: query.limit
      - text: List billing codes matching CPT {code}, ordered by {order_by}.
        slots:
          code: query.code
          order_by: query.order_by
      method: generated
      generated: '2026-10-02'
- target: $.paths['/api/2.0/billing_codes/'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a CPT billing code
      effect: write
      questions:
      - What's required to create a billing code with a description?
      - Can I create a CPT code with its display sequence?
      instructions:
      - text: Create billing code {code} described {description} for practice {practice}.
        slots:
          code: requestBody.code
          description: requestBody.description
          practice: requestBody.practice
      - text: Create CPT {code}, {description}, in {practice} at sequence {sequence}.
        slots:
          code: requestBody.code
          description: requestBody.description
          practice: requestBody.practice
          sequence: requestBody.sequence
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/billing_codes/{id}/'].get
  update:
    x-apievangelist-phrasing:
      intent: Retrieve a CPT billing code
      effect: read
      questions:
      - Can I retrieve a billing code's description by id?
      - Where do I retrieve a single CPT code record?
      instructions:
      - text: Retrieve billing code {id}.
        slots:
          id: path.id
      - text: Retrieve the description for billing code {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/billing_codes/{id}/'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace a CPT billing code
      effect: write
      questions:
      - Can I replace a billing code's code, description and practice at once?
      - What's required to fully overwrite a billing code?
      instructions:
      - text: Replace billing code {id} with CPT {code}, {description}, practice {practice}.
        slots:
          id: path.id
          code: requestBody.code
          description: requestBody.description
          practice: requestBody.practice
      - text: 'Overwrite billing code {id}: {code}, {description}, {practice}, charge {charge}.'
        slots:
          id: path.id
          code: requestBody.code
          description: requestBody.description
          practice: requestBody.practice
          charge: requestBody.charge
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/billing_codes/{id}/'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a CPT billing code
      effect: destructive
      questions:
      - How do I delete a CPT code the practice no longer bills?
      - Can I remove a billing code from Practice Settings via the API?
      instructions:
      - text: Delete billing code {id}.
        slots:
          id: path.id
      - text: Remove the CPT code record {id} from the practice.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/billing_codes/{id}/'].patch
  update:
    x-apievangelist-phrasing:
      intent: Partially update a CPT billing code
      effect: write
      questions:
      - Can I partially update just a billing code's description?
      - How do I patch a billing code's charge by id?
      instructions:
      - text: Partially update billing code {id} description to {description}.
        slots:
          id: path.id
          description: requestBody.description
      - text: Patch billing code {id} charge to {charge}.
        slots:
          id: path.id
          charge: requestBody.charge
      method: generated
      generated: '2026-09-26'