# 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 Insurance Plans API
  version: 1.0.0
extends: openapi/elation-health-insurance-plans-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: 12
- target: $.paths['/insurance_plans/{id}/'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an insurance plan (legacy endpoint)
      effect: read
      questions:
      - How do I look up one insurance plan by id on the legacy path?
      - Which insurance company does a given plan belong to, per the original endpoint?
      instructions:
      - text: Get legacy insurance plan {id}.
        slots:
          id: path.id
      - text: Show insurance plan {id} from the older endpoint.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insurance_plans/{id}/'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an insurance plan (legacy endpoint)
      effect: destructive
      questions:
      - How do I remove an insurance plan using the legacy endpoint?
      - Can I delete a plan my practice no longer accepts through the original path?
      instructions:
      - text: Delete legacy insurance plan {id}.
        slots:
          id: path.id
      - text: Remove insurance plan {id} via the old endpoint.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insurance_plans/'].get
  update:
    x-apievangelist-phrasing:
      intent: Find insurance plans (legacy endpoint)
      effect: read
      questions:
      - What insurance plans has my practice set up, per the legacy endpoint?
      - Can the original plan search filter by insurance company?
      instructions:
      - text: Find legacy insurance plans for practice {practice}.
        slots:
          practice: query.practice
      - text: Search the old endpoint for plans from insurance company {company}.
        slots:
          company: query.insurance_company
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insurance_plans/'].post
  update:
    x-apievangelist-phrasing:
      intent: Add an insurance plan (legacy endpoint)
      effect: write
      questions:
      - How do I add a new insurance plan for my practice through the legacy endpoint?
      - What does the original plan create call require?
      instructions:
      - text: Create legacy insurance plan {name} under company {company} for practice {practice}.
        slots:
          name: requestBody.name
          company: requestBody.insurance_company
          practice: requestBody.practice
      - text: Add plan {name} for insurer {company} in practice {practice} using the old endpoint.
        slots:
          name: requestBody.name
          company: requestBody.insurance_company
          practice: requestBody.practice
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insurance_plans/:id/'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace an insurance plan (legacy PUT)
      effect: write
      questions:
      - Can I overwrite an insurance plan's name and company with the legacy PUT?
      - Which legacy call requires every insurance plan field to be resent?
      instructions:
      - text: Replace the legacy insurance plan with name {name}, company {company} and practice {practice}.
        slots:
          name: requestBody.name
          company: requestBody.insurance_company
          practice: requestBody.practice
      - text: Overwrite an old-endpoint plan in full, renaming it {name}.
        slots:
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insurance_plans/:id/'].patch
  update:
    x-apievangelist-phrasing:
      intent: Rename or reassign an insurance plan (legacy PATCH)
      effect: write
      questions:
      - Can I just rename an insurance plan with the legacy PATCH?
      - How do I move a plan to a different insurance company without resending everything on the old path?
      instructions:
      - text: Patch the legacy insurance plan to be named {name}.
        slots:
          name: requestBody.name
      - text: Reassign the plan to insurance company {company} with the old PATCH endpoint.
        slots:
          company: requestBody.insurance_company
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/insurance_plans/'].get
  update:
    x-apievangelist-phrasing:
      intent: List insurance plans (v2.0)
      effect: read
      questions:
      - How do I page through all insurance plans in the 2.0 API?
      - Can I list version 2.0 plans for one insurance company, sorted?
      instructions:
      - text: List v2.0 insurance plans for practice {practice}.
        slots:
          practice: query.practice
      - text: List 2.0 plans from insurer {company} ordered by {order_by}.
        slots:
          company: query.insurance_company
          order_by: query.order_by
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/insurance_plans/'].post
  update:
    x-apievangelist-phrasing:
      intent: Add an insurance plan (v2.0)
      effect: write
      questions:
      - How do I create an insurance plan in version 2.0?
      - Which fields are required for a new plan in the 2.0 API?
      instructions:
      - text: Create v2.0 insurance plan {name} for company {company} in practice {practice}.
        slots:
          name: requestBody.name
          company: requestBody.insurance_company
          practice: requestBody.practice
      - text: Set up a 2.0 plan called {name} under insurer {company} for practice {practice}.
        slots:
          name: requestBody.name
          company: requestBody.insurance_company
          practice: requestBody.practice
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/insurance_plans/{id}/'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an insurance plan (v2.0)
      effect: read
      questions:
      - How do I fetch a single insurance plan in the 2.0 API?
      - Does the v2.0 plan record show which patients are on it?
      instructions:
      - text: Get v2.0 insurance plan {id}.
        slots:
          id: path.id
      - text: Retrieve plan {id} from the 2.0 API.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/insurance_plans/{id}/'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace an insurance plan (v2.0 PUT)
      effect: write
      questions:
      - Can I fully replace an insurance plan in version 2.0, including its patients?
      - Which 2.0 call overwrites every field of an insurance plan?
      instructions:
      - text: Replace v2.0 insurance plan {id} with name {name}, company {company} and practice {practice}.
        slots:
          id: path.id
          name: requestBody.name
          company: requestBody.insurance_company
          practice: requestBody.practice
      - text: Overwrite 2.0 plan {id} with patient list {patients}.
        slots:
          id: path.id
          patients: requestBody.patients
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/insurance_plans/{id}/'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an insurance plan (v2.0)
      effect: destructive
      questions:
      - How do I delete an insurance plan through the 2.0 API?
      - Can I remove an outdated plan in version 2.0?
      instructions:
      - text: Delete v2.0 insurance plan {id}.
        slots:
          id: path.id
      - text: Remove plan {id} using the 2.0 insurance plans endpoint.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/insurance_plans/{id}/'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update some insurance plan fields (v2.0)
      effect: write
      questions:
      - Can I rename an insurance plan in the 2.0 API without resending it all?
      - Which v2.0 call changes only part of a plan?
      instructions:
      - text: Patch v2.0 insurance plan {id} to name {name}.
        slots:
          id: path.id
          name: requestBody.name
      - text: Move 2.0 plan {id} to insurance company {company}.
        slots:
          id: path.id
          company: requestBody.insurance_company
      method: generated
      generated: '2026-09-26'