# 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 Card API
  version: 1.0.0
extends: openapi/elation-health-insurance-card-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: 3
- target: $.paths['/api/2.0/patients/{id}/insurance_cards/'].get
  update:
    x-apievangelist-phrasing:
      intent: List a patient's insurance card images
      effect: read
      questions:
      - How do I see the insurance card photos on file for a patient?
      - Are both front and back card images returned for each insurance?
      instructions:
      - text: List insurance cards for patient {id}.
        slots:
          id: path.id
      - text: Show every scanned insurance card image on patient {id}'s chart.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/patients/{id}/insurance_cards/'].post
  update:
    x-apievangelist-phrasing:
      intent: Upload a patient's insurance card image
      effect: write
      questions:
      - Can I upload a photo of the front or back of a patient's insurance card?
      - What does rank mean when adding an insurance card image?
      instructions:
      - text: Upload card image {image} as the {side} side of rank {rank} insurance for patient {id}.
        slots:
          image: requestBody.image
          side: requestBody.side
          rank: requestBody.rank
          id: path.id
      - text: Add the {side} of patient {id}'s primary card, rank {rank}, from {image}.
        slots:
          side: requestBody.side
          id: path.id
          rank: requestBody.rank
          image: requestBody.image
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/patients/{id}/insurance_cards/'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a patient's insurance card image
      effect: destructive
      questions:
      - Can I remove an outdated insurance card image from a patient?
      - Is there an option to archive a card image instead of deleting it?
      instructions:
      - text: Delete the {side} card image of rank {rank} insurance for patient {id}.
        slots:
          side: query.side
          rank: query.rank
          id: path.id
      - text: Archive patient {id}'s rank {rank} {side} card with archive set to {archive}.
        slots:
          id: path.id
          rank: query.rank
          side: query.side
          archive: query.archive
      method: generated
      generated: '2026-09-26'