# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Settings Patient Provider Team Members API
  version: 1.0.0
extends: openapi/elation-health-patient-provider-team-members-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['/patient-provider-team-members'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a provider to a patient's care team
      effect: write
      questions:
      - How do I add a physician to a patient's provider team?
      - Can I record why a provider is on a patient's care team?
      instructions:
      - text: Add physician {physician} to patient provider team {team}.
        slots:
          physician: requestBody.physician_id
          team: requestBody.patient_provider_team_id
      - text: Put physician {physician} on care team {team} for {reason}.
        slots:
          physician: requestBody.physician_id
          team: requestBody.patient_provider_team_id
          reason: requestBody.treatment_reason
      method: generated
      generated: '2026-09-26'
- target: $.paths['/patient-provider-team-members/{team_member_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a provider from a patient's care team
      effect: destructive
      questions:
      - Can I take a provider off a patient's care team?
      - Can I delete a care team member?
      instructions:
      - text: Remove team member {member} from the patient's provider team.
        slots:
          member: path.team_member_id
      - text: Delete care team member {member}.
        slots:
          member: path.team_member_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/patient-provider-team-members/{team_member_id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a care team member's treatment reason
      effect: write
      questions:
      - Can I change the treatment reason for a provider on a care team?
      - Is it possible to edit a care team member's details?
      instructions:
      - text: Set team member {member}'s treatment reason to {reason}.
        slots:
          member: path.team_member_id
          reason: requestBody.treatment_reason
      - text: Update care team member {member}.
        slots:
          member: path.team_member_id
      method: generated
      generated: '2026-09-26'