# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Salesforce Appointment API
  version: 1.0.0
extends: openapi/salesforce-appointment-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: 2
- target: $.paths['/data/v64.0/scheduling/getAppointmentSlots'].post
  update:
    x-apievangelist-phrasing:
      intent: Find available appointment time slots
      effect: read
      questions:
      - What appointment times are open for a work type between two dates?
      - Can I find open slots limited to certain service territories?
      instructions:
      - text: Find appointment slots for work type group {work_type_group} from {start} to {end}.
        slots:
          work_type_group: requestBody.workTypeGroupId
          start: requestBody.startTime
          end: requestBody.endTime
      - text: Show open time slots in territories {territories} for account {account} between {start} and {end}.
        slots:
          territories: requestBody.territoryIds
          account: requestBody.accountId
          start: requestBody.startTime
          end: requestBody.endTime
      method: generated
      generated: '2026-09-26'
- target: $.paths['/data/v64.0/scheduling/getAppointmentCandidates'].post
  update:
    x-apievangelist-phrasing:
      intent: Find service resources available for an appointment
      effect: read
      questions:
      - Which service resources are available to take an appointment?
      - Who can be assigned to a work type in a set of territories this week?
      instructions:
      - text: Find appointment candidates for work type group {work_type_group} from {start} to {end}.
        slots:
          work_type_group: requestBody.workTypeGroupId
          start: requestBody.startTime
          end: requestBody.endTime
      - text: List service resources who can take a job in territories {territories} using policy {policy}.
        slots:
          territories: requestBody.territoryIds
          policy: requestBody.schedulingPolicyId
      method: generated
      generated: '2026-09-26'