# 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 Provider Team API
  version: 1.0.0
extends: openapi/elation-health-provider-team-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: 9
- target: $.paths['/api/2.0/patient-provider-team-members/'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a physician to a patient's care team
      effect: write
      questions:
      - How do I add a physician to a patient's provider team in Elation?
      - Can I record the treatment reason when adding a care team member?
      instructions:
      - text: Add physician {physician_id} to provider team {patient_provider_team_id}.
        slots:
          physician_id: requestBody.physician_id
          patient_provider_team_id: requestBody.patient_provider_team_id
      - text: Put physician {physician_id} on team {patient_provider_team_id} for {treatment_reason}.
        slots:
          physician_id: requestBody.physician_id
          patient_provider_team_id: requestBody.patient_provider_team_id
          treatment_reason: requestBody.treatment_reason
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/patient-provider-team-members/{id}/'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace a care team member
      effect: write
      questions:
      - Can I replace a care team member's whole record?
      - Which call overwrites a provider team member entirely?
      instructions:
      - text: Replace team member {id} with physician {physician_id} ranked {rank}.
        slots:
          id: path.id
          physician_id: requestBody.physician_id
          rank: requestBody.rank
      - text: Overwrite provider team member {id} in full.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/patient-provider-team-members/{id}/'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a physician from a care team
      effect: destructive
      questions:
      - How do I take a physician off a patient's care team?
      - Can a provider team member be deleted?
      instructions:
      - text: Remove team member {id} from the care team.
        slots:
          id: path.id
      - text: Delete provider team member {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/patient-provider-team-members/{id}/'].patch
  update:
    x-apievangelist-phrasing:
      intent: Change a care team member's rank or group
      effect: write
      questions:
      - Can I change the rank of a physician on a patient's care team?
      - How do I move a team member into a different group?
      instructions:
      - text: Set the rank of team member {id} to {rank}.
        slots:
          id: path.id
          rank: requestBody.rank
      - text: Move care team member {id} to group {group}.
        slots:
          id: path.id
          group: requestBody.group
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/patient-provider-teams/'].get
  update:
    x-apievangelist-phrasing:
      intent: List patient provider teams
      effect: read
      questions:
      - Which patient care teams exist across my practice?
      - Can I page through provider teams in a set order?
      instructions:
      - text: List patient provider teams ordered by {order_by}.
        slots:
          order_by: query.order_by
      - text: Show the first {limit} provider teams.
        slots:
          limit: query.limit
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/patient-provider-teams/{id}/'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a provider team by id
      effect: read
      questions:
      - How do I look up one provider team by its team id?
      - What does a patient provider team record contain?
      instructions:
      - text: Get provider team {id}.
        slots:
          id: path.id
      - text: Show the care team record with team id {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/patient-provider-teams/{id}/team_members/'].get
  update:
    x-apievangelist-phrasing:
      intent: List the members of a provider team
      effect: read
      questions:
      - Who are the physicians on a given provider team?
      - Can I see every member and their rank for one care team?
      instructions:
      - text: List the members of provider team {id}.
        slots:
          id: path.id
      - text: Show who belongs to care team {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/patients/{id}/patient_provider_team/'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a patient's provider team
      effect: read
      questions:
      - How do I find the care team for a specific patient?
      - What happens when I request a patient's team and one already exists?
      instructions:
      - text: Get the provider team for patient {id}.
        slots:
          id: path.id
      - text: Look up patient {id}'s care team.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/patients/{id}/patient_provider_team/'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a patient's provider team
      effect: write
      questions:
      - How do I set up a care team for a patient who doesn't have one?
      - Does creating a patient's provider team fail if one already exists?
      instructions:
      - text: Create a provider team {patient_provider_team_id} for patient {id}.
        slots:
          patient_provider_team_id: requestBody.patient_provider_team_id
          id: path.id
      - text: Start a care team for patient {id} with members {team_members}.
        slots:
          id: path.id
          team_members: requestBody.team_members
      method: generated
      generated: '2026-09-26'