API Evangelist conversational phrasing for Elation Health Appointment Types API

# 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 Appointment Types API
  version: 1.0.0
extends: openapi/elation-health-appointment-types-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 9
- target: $.paths['/appointment_types/'].get
  update:
    x-apievangelist-phrasing:
      intent: Find appointment types (legacy)
      effect: read
      questions:
      - How do I see the appointment types set up on the legacy endpoint?
      - What does the old unversioned appointment types list return?
      instructions:
      - text: Find all appointment types on the legacy endpoint.
      - text: Show the old-style appointment type catalog.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/appointment_types/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up an appointment type (legacy)
      effect: read
      questions:
      - Can I fetch a single appointment type from the legacy API?
      - Which legacy call shows the details of one visit type?
      instructions:
      - text: Fetch legacy appointment type {id}.
        slots:
          id: path.id
      - text: Show a single visit type from the original endpoint.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/appointment_types/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Edit an appointment type (legacy PATCH)
      effect: write
      questions:
      - Can I change an appointment type's color or abbreviation with the legacy PATCH?
      - How do I mark a visit type as telehealth on the old endpoint?
      instructions:
      - text: Set legacy appointment type {id}'s default duration to {default_duration} and color to {color}.
        slots:
          id: path.id
          default_duration: requestBody.default_duration
          color: requestBody.color
      - text: Flag the old-style visit type {name} as telehealth {is_telehealth}.
        slots:
          name: requestBody.name
          is_telehealth: requestBody.is_telehealth
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/2.0/appointment_types/'].get
  update:
    x-apievangelist-phrasing:
      intent: List appointment types
      effect: read
      questions:
      - Which appointment types does my practice offer in Elation?
      - Can I search appointment types by name?
      instructions:
      - text: List appointment types for practice {practice}.
        slots:
          practice: query.practice
      - text: Find appointment types named {name}.
        slots:
          name: query.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/appointment_types/'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an appointment type
      effect: write
      questions:
      - How do I add a new visit type with a default length?
      - Can a new appointment type be bookable by patients?
      instructions:
      - text: Create appointment type {name} lasting {default_duration} minutes at practice {practice}.
        slots:
          name: requestBody.name
          default_duration: requestBody.default_duration
          practice: requestBody.practice
      - text: Add a patient-bookable {patient_bookable} visit type {name} for practice {practice} with duration {default_duration}.
        slots:
          patient_bookable: requestBody.patient_bookable
          name: requestBody.name
          practice: requestBody.practice
          default_duration: requestBody.default_duration
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/appointment_types/{id}/'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one appointment type
      effect: read
      questions:
      - How do I read the settings of one appointment type in v2?
      - What note templates are linked to an appointment type?
      instructions:
      - text: Get appointment type {id}.
        slots:
          id: path.id
      - text: Retrieve v2 appointment type {id} with its templates.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/appointment_types/{id}/'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace an appointment type
      effect: write
      questions:
      - Can I replace an appointment type's full configuration?
      - Which v2 call overwrites a visit type entirely?
      instructions:
      - text: Replace appointment type {id} with name {name} and duration {default_duration}.
        slots:
          id: path.id
          name: requestBody.name
          default_duration: requestBody.default_duration
      - text: Overwrite v2 appointment type {id} for practice {practice}.
        slots:
          id: path.id
          practice: requestBody.practice
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/appointment_types/{id}/'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an appointment type
      effect: destructive
      questions:
      - How do I delete an appointment type we no longer use?
      - Can a visit type be removed in v2?
      instructions:
      - text: Delete appointment type {id}.
        slots:
          id: path.id
      - text: Remove v2 visit type {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/appointment_types/{id}/'].patch
  update:
    x-apievangelist-phrasing:
      intent: Edit part of an appointment type
      effect: write
      questions:
      - Can I change just the color of an appointment type in v2?
      - How do I change how many hours before a visit patient forms go out?
      instructions:
      - text: Change the color of appointment type {id} to {color}.
        slots:
          id: path.id
          color: requestBody.color
      - text: Send patient forms {patient_form_hours_prior} hours before visits of type {id}.
        slots:
          patient_form_hours_prior: requestBody.patient_form_hours_prior
          id: path.id
      method: generated
      generated: '2026-09-26'