# 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 Medication Order Templates API
  version: 1.0.0
extends: openapi/elation-health-medication-order-templates-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['/medication_order_templates/'].get
  update:
    x-apievangelist-phrasing:
      intent: Search prescription templates (legacy)
      effect: read
      questions:
      - Can I find a practice's saved prescription templates on the older unversioned endpoint?
      - Does the legacy template search let me include deleted templates?
      instructions:
      - text: Find legacy medication order templates for practice {practice}.
        slots:
          practice: query.practice
      - text: Search old-route templates deleted on or after {deleted_date__gte}.
        slots:
          deleted_date__gte: query.deleted_date__gte
      method: generated
      generated: '2026-09-26'
- target: $.paths['/medication_order_templates/'].post
  update:
    x-apievangelist-phrasing:
      intent: Save a prescription template (legacy)
      effect: write
      questions:
      - Which legacy call saves a reusable prescription with quantity and refills?
      - What must I send to add a medication order template on the old path?
      instructions:
      - text: Create a legacy template for medication {medication} at practice {practice} with {auth_refills} refills.
        slots:
          medication: requestBody.medication
          practice: requestBody.practice
          auth_refills: requestBody.auth_refills
      - text: 'Save an old-route template for {medication}: quantity {qty} {qty_units}, directions {directions}, practice {practice}.'
        slots:
          medication: requestBody.medication
          qty: requestBody.qty
          qty_units: requestBody.qty_units
          directions: requestBody.directions
          practice: requestBody.practice
      method: generated
      generated: '2026-09-26'
- target: $.paths['/medication_order_templates/{id}/'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up a prescription template (legacy)
      effect: read
      questions:
      - What does the legacy endpoint return for one medication order template?
      - Can I read a saved prescription template by id on the unversioned path?
      instructions:
      - text: Fetch legacy medication order template {id}.
        slots:
          id: path.id
      - text: Open saved prescription template {id} from the old route.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/medication_order_templates/{id}/'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace a prescription template (legacy PUT)
      effect: write
      questions:
      - Which legacy PUT overwrites a whole prescription template?
      - Do I resend practice and medication when replacing a template on the old path?
      instructions:
      - text: Replace legacy template {id} with medication {medication} for practice {practice}.
        slots:
          id: path.id
          medication: requestBody.medication
          practice: requestBody.practice
      - text: Overwrite old-route template {id} with directions {directions}, medication {medication}, practice {practice}.
        slots:
          id: path.id
          directions: requestBody.directions
          medication: requestBody.medication
          practice: requestBody.practice
      method: generated
      generated: '2026-09-26'
- target: $.paths['/medication_order_templates/{id}/'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a prescription template (legacy)
      effect: destructive
      questions:
      - Can I delete a saved prescription template using the older unversioned API?
      - Which old call removes a medication order template?
      instructions:
      - text: Delete legacy template {id}.
        slots:
          id: path.id
      - text: Remove saved prescription template {id} via the original route.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/medication_order_templates/{id}/'].patch
  update:
    x-apievangelist-phrasing:
      intent: Patch a prescription template (legacy PATCH)
      effect: write
      questions:
      - Can I change only the refill count on a template with the legacy PATCH?
      - Is there an old-path partial edit for a template's directions?
      instructions:
      - text: Set refills on legacy template {id} to {auth_refills}.
        slots:
          id: path.id
          auth_refills: requestBody.auth_refills
      - text: Patch the directions of old-route template {id} to {directions}.
        slots:
          id: path.id
          directions: requestBody.directions
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/medication_order_templates/'].get
  update:
    x-apievangelist-phrasing:
      intent: List prescription templates
      effect: read
      questions:
      - How do I list the prescription templates my practice has saved?
      - Can I page and sort v2.0 medication order templates?
      - Are deleted templates excluded from the list by default?
      instructions:
      - text: List v2.0 medication order templates for practice {practice}.
        slots:
          practice: query.practice
      - text: Show templates that are not deleted where deleted-null is {deleted_date__isnull}, ordered by {order_by}.
        slots:
          deleted_date__isnull: query.deleted_date__isnull
          order_by: query.order_by
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/medication_order_templates/'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a prescription template
      effect: write
      questions:
      - What's needed to create a reusable prescription in API v2.0?
      - Can a new template pin a specific NDC and a display rank?
      instructions:
      - text: Create a v2.0 template for medication {medication} at practice {practice}, quantity {qty} {qty_units}.
        slots:
          medication: requestBody.medication
          practice: requestBody.practice
          qty: requestBody.qty
          qty_units: requestBody.qty_units
      - text: Add a template for {medication} with NDC {specific_ndc} ranked {rank} at practice {practice}.
        slots:
          medication: requestBody.medication
          specific_ndc: requestBody.specific_ndc
          rank: requestBody.rank
          practice: requestBody.practice
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/medication_order_templates/{id}/'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one prescription template
      effect: read
      questions:
      - What does a single v2.0 prescription template contain?
      - Can I see the default directions saved on a template?
      instructions:
      - text: Retrieve v2.0 medication order template {id}.
        slots:
          id: path.id
      - text: Show me the quantity and directions on template {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/medication_order_templates/{id}/'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace a prescription template
      effect: write
      questions:
      - Which v2.0 call fully replaces a medication order template?
      - Can I swap the medication on a template with a full update?
      instructions:
      - text: Replace v2.0 template {id} with medication {medication} for practice {practice}.
        slots:
          id: path.id
          medication: requestBody.medication
          practice: requestBody.practice
      - text: Do a full PUT on template {id} setting NDC {specific_ndc}, medication {medication}, practice {practice}.
        slots:
          id: path.id
          specific_ndc: requestBody.specific_ndc
          medication: requestBody.medication
          practice: requestBody.practice
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/medication_order_templates/{id}/'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a prescription template
      effect: destructive
      questions:
      - Can I delete a prescription template nobody uses anymore?
      - What removes a medication order template in API v2.0?
      instructions:
      - text: Delete v2.0 template {id}.
        slots:
          id: path.id
      - text: Remove unused prescription template {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/medication_order_templates/{id}/'].patch
  update:
    x-apievangelist-phrasing:
      intent: Edit part of a prescription template
      effect: write
      questions:
      - Can I reorder a template by changing just its rank?
      - Is there a v2.0 partial update for a template's quantity?
      instructions:
      - text: Set the rank of template {id} to {rank}.
        slots:
          id: path.id
          rank: requestBody.rank
      - text: Change the quantity on v2.0 template {id} to {qty}.
        slots:
          id: path.id
          qty: requestBody.qty
      method: generated
      generated: '2026-09-26'