# 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 Patient Profile Photo API
  version: 1.0.0
extends: openapi/elation-health-patient-profile-photo-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: 4
- target: $.paths['/api/2.0/patients/{id}/get_photo/'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a patient's photo via get_photo
      effect: read
      questions:
      - Is there a get_photo endpoint for downloading a patient's picture?
      - Which call returns a patient photo from the get_photo path?
      instructions:
      - text: Download patient {id}'s picture from the get_photo endpoint.
        slots:
          id: path.id
      - text: Use get_photo to fetch the image for patient {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/patients/{id}/profile_image/'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a patient's profile image
      effect: read
      questions:
      - How do I show a patient's profile image in my app?
      - Can I read the profile_image record for a patient in /api/2.0?
      instructions:
      - text: Get the profile image for patient {id}.
        slots:
          id: path.id
      - text: Read the /api/2.0 profile_image record on chart {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/patients/{id}/profile_image/'].post
  update:
    x-apievangelist-phrasing:
      intent: Upload a patient's profile image
      effect: write
      questions:
      - How do I upload a new headshot for a patient as base64?
      - Can I send the image's content type and dimensions with the upload?
      instructions:
      - text: Upload image {base_64} named {original_filename} as the profile image for patient {id}.
        slots:
          base_64: requestBody.base_64
          original_filename: requestBody.original_filename
          id: path.id
      - text: Set chart {id}'s picture for patient {patient} in practice {practice} with content type {content_type}.
        slots:
          id: path.id
          patient: requestBody.patient
          practice: requestBody.practice
          content_type: requestBody.content_type
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/patients/{id}/profile_image/'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a patient's profile image
      effect: destructive
      questions:
      - How do I remove a patient's profile picture in /api/2.0?
      - Can I clear the wrong headshot from a patient record?
      instructions:
      - text: Delete the profile image for patient {id}.
        slots:
          id: path.id
      - text: Clear the /api/2.0 headshot on chart {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'