API Evangelist conversational phrasing for Meetings Meeting External API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Meetings Meeting External API
  version: 1.0.0
extends: openapi/vendasta-meetingexternal-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['/v1/meetings/book'].post
  update:
    x-apievangelist-phrasing:
      intent: Book a meeting
      effect: write
      questions:
      - How do I book a meeting for a business on one of its event types?
      - Can I pick a specific host and attach form answers when booking a meeting?
      instructions:
      - text: Book event type {event_type} at business {business} starting {start} for {attendees}.
        slots:
          event_type: requestBody.eventTypeId
          business: requestBody.businessId
          start: requestBody.start
          attendees: requestBody.attendees
      - text: Schedule a meeting with host {host} for {attendees} at {start}, business {business}, event type {event_type}.
        slots:
          host: requestBody.hostUserId
          attendees: requestBody.attendees
          start: requestBody.start
          business: requestBody.businessId
          event_type: requestBody.eventTypeId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/meetings/cancel'].post
  update:
    x-apievangelist-phrasing:
      intent: Cancel a booked meeting
      effect: destructive
      questions:
      - Can I cancel a meeting that has already been booked?
      - Is there a way to record why a meeting was cancelled?
      instructions:
      - text: Cancel meeting {meeting} for business {business}.
        slots:
          meeting: requestBody.meetingId
          business: requestBody.businessId
      - text: Cancel meeting {meeting} at {business} with reason {reason}.
        slots:
          meeting: requestBody.meetingId
          business: requestBody.businessId
          reason: requestBody.cancellationReason
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/meetings/event-type-availability-slots'].post
  update:
    x-apievangelist-phrasing:
      intent: Find open time slots for an event type
      effect: read
      questions:
      - What times are still open to book for an event type?
      - Can I check a specific host's availability in my time zone?
      instructions:
      - text: Show free slots for event type {event_type} at {business} during {span} in {tz}.
        slots:
          event_type: requestBody.eventTypeId
          business: requestBody.businessId
          span: requestBody.timeSpan
          tz: requestBody.timeZone
      - text: Find host {host}'s open slots for event type {event_type} at {business} over {span}, time zone {tz}.
        slots:
          host: requestBody.hostUserId
          event_type: requestBody.eventTypeId
          business: requestBody.businessId
          span: requestBody.timeSpan
          tz: requestBody.timeZone
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/meetings/event-types'].post
  update:
    x-apievangelist-phrasing:
      intent: List a business's team event types
      effect: read
      questions:
      - Which team meeting types has a business set up?
      - Can I page through the shared team event types?
      instructions:
      - text: List team event types for business {business}.
        slots:
          business: requestBody.businessId
      - text: Show {size} team event types per page for {business}.
        slots:
          size: requestBody.pageSize
          business: requestBody.businessId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/meetings/groups'].post
  update:
    x-apievangelist-phrasing:
      intent: List meeting groups for a business
      effect: read
      questions:
      - What meeting groups exist for a business?
      - Where can I see all the scheduling groups a business has configured?
      instructions:
      - text: List meeting groups for business {business}.
        slots:
          business: requestBody.businessId
      - text: Show every scheduling group under {business}.
        slots:
          business: requestBody.businessId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/meetings/reschedule'].post
  update:
    x-apievangelist-phrasing:
      intent: Reschedule a meeting
      effect: write
      questions:
      - Can I move a booked meeting to a different time?
      - Is it possible to change a meeting's location when rescheduling it?
      instructions:
      - text: Move meeting {meeting} at {business} to {start} in {tz}.
        slots:
          meeting: requestBody.meetingId
          business: requestBody.businessId
          start: requestBody.startTime
          tz: requestBody.timeZone
      - text: Reschedule meeting {meeting} for {business} to location {location}, time zone {tz}.
        slots:
          meeting: requestBody.meetingId
          business: requestBody.businessId
          location: requestBody.location
          tz: requestBody.timeZone
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/meetings/services'].post
  update:
    x-apievangelist-phrasing:
      intent: List bookable services for a business
      effect: read
      questions:
      - Which services can customers book with a business?
      - Can I get the full list of meeting services a business offers?
      instructions:
      - text: List the bookable services for business {business}.
        slots:
          business: requestBody.businessId
      - text: Show all services {business} offers for appointments.
        slots:
          business: requestBody.businessId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/meetings/user-event-types'].post
  update:
    x-apievangelist-phrasing:
      intent: List a user's event types
      effect: read
      questions:
      - What personal and team event types does one staff member have?
      - Can I see which meeting types a specific user can host?
      instructions:
      - text: List event types for user {user} at business {business}.
        slots:
          user: requestBody.userId
          business: requestBody.businessId
      - text: Show the personal and team meeting types of {user} in {business}.
        slots:
          user: requestBody.userId
          business: requestBody.businessId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/meetings/users'].post
  update:
    x-apievangelist-phrasing:
      intent: List a business's meeting hosts
      effect: read
      questions:
      - Who are the users at a business that can take meetings?
      - Can I list the people in a business's scheduling setup?
      instructions:
      - text: List meeting users for business {business}.
        slots:
          business: requestBody.businessId
      - text: Show the staff who can host meetings at {business}.
        slots:
          business: requestBody.businessId
      method: generated
      generated: '2026-10-01'