# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Nylas Group Events API
  version: 1.0.0
extends: openapi/nylas-group-events-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: 6
- target: $.paths['/v3/grants/{grant_id}/scheduling/configurations/{configuration_id}/group-events'].get
  update:
    x-apievangelist-phrasing:
      intent: List group events in a time range
      effect: read
      questions:
      - Which group sessions are scheduled on a Configuration this week?
      - Can I list group events for one calendar between two times?
      instructions:
      - text: List group events for configuration {configuration} on {grant} in calendar {calendar_id} from {start_time} to {end_time}.
        slots:
          configuration: path.configuration_id
          grant: path.grant_id
          calendar_id: query.calendar_id
          start_time: query.start_time
          end_time: query.end_time
      - text: Show group events on calendar {calendar_id} for configuration {configuration} via {grant} between {start_time} and {end_time}.
        slots:
          calendar_id: query.calendar_id
          configuration: path.configuration_id
          grant: path.grant_id
          start_time: query.start_time
          end_time: query.end_time
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v3/grants/{grant_id}/scheduling/configurations/{configuration_id}/group-events'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a group event with a capacity
      effect: write
      questions:
      - How do I set up a class or webinar that several people can book into?
      - Can I cap the number of attendees on a group event?
      instructions:
      - text: Create group event {title} with capacity {capacity} at {when} on calendar {calendar_id} for configuration {configuration} and {grant}.
        slots:
          title: requestBody.title
          capacity: requestBody.capacity
          when: requestBody.when
          calendar_id: requestBody.calendar_id
          configuration: path.configuration_id
          grant: path.grant_id
      - text: Schedule a recurring group session {title} for {participants} on configuration {configuration} via {grant}.
        slots:
          title: requestBody.title
          participants: requestBody.participants
          configuration: path.configuration_id
          grant: path.grant_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v3/grants/{grant_id}/scheduling/configurations/{configuration_id}/group-events/{event_id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a group event
      effect: write
      questions:
      - Can I raise the capacity of a group event people already booked?
      - How do I move an existing group session to a new time?
      instructions:
      - text: Change the capacity of group event {event} in configuration {configuration} on {grant} to {capacity}.
        slots:
          event: path.event_id
          configuration: path.configuration_id
          grant: path.grant_id
          capacity: requestBody.capacity
      - text: Move group event {event} for configuration {configuration} via {grant} to {when}.
        slots:
          event: path.event_id
          configuration: path.configuration_id
          grant: path.grant_id
          when: requestBody.when
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v3/grants/{grant_id}/scheduling/configurations/{configuration_id}/group-events/{event_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a group event
      effect: destructive
      questions:
      - How do I cancel and remove a group session entirely?
      - Can I delete one group event from a scheduling Configuration?
      instructions:
      - text: Delete group event {event} from configuration {configuration} on {grant}.
        slots:
          event: path.event_id
          configuration: path.configuration_id
          grant: path.grant_id
      - text: Remove the group session {event} in configuration {configuration} for {grant}.
        slots:
          event: path.event_id
          configuration: path.configuration_id
          grant: path.grant_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v3/scheduling/configurations/{configuration_id}/import-group-events'].post
  update:
    x-apievangelist-phrasing:
      intent: Import existing events as group events
      effect: write
      questions:
      - Can I bring existing calendar events into a group events Configuration?
      - What's the limit on events imported per request?
      instructions:
      - text: Import existing events into group configuration {configuration}.
        slots:
          configuration: path.configuration_id
      - text: Pull current calendar events into configuration {configuration} as group events.
        slots:
          configuration: path.configuration_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v3/scheduling/configurations/{configuration_id}/group-events/validate-timeslot'].post
  update:
    x-apievangelist-phrasing:
      intent: Check a group event slot is still valid
      effect: read
      questions:
      - Is a group event time slot still bookable, or was it changed or filled?
      - How can I tell if a group session was deleted before someone books it?
      instructions:
      - text: Validate that group event {event_id} on calendar {calendar_id} in configuration {configuration} is still bookable.
        slots:
          event_id: requestBody.event_id
          calendar_id: requestBody.calendar_id
          configuration: path.configuration_id
      - text: Check whether slot {event_id} in calendar {calendar_id} for configuration {configuration} has changed.
        slots:
          event_id: requestBody.event_id
          calendar_id: requestBody.calendar_id
          configuration: path.configuration_id
      method: generated
      generated: '2026-09-26'