# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Nylas Events API
  version: 1.0.0
extends: openapi/nylas-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: 7
- target: $.paths['/v3/grants/{grant_id}/events'].get
  update:
    x-apievangelist-phrasing:
      intent: List events on a user's calendar
      effect: read
      questions:
      - How do I list upcoming events on a connected user's calendar?
      - Can I expand recurring events into individual occurrences when listing?
      - Is there a way to find calendar events by title or attendee?
      instructions:
      - text: List events on calendar {calendar_id} for {grant_id}.
        slots:
          calendar_id: query.calendar_id
          grant_id: path.grant_id
      - text: Show events on {calendar_id} in {grant_id} between {start} and {end}.
        slots:
          calendar_id: query.calendar_id
          grant_id: path.grant_id
          start: query.start
          end: query.end
      - text: Find events titled {title} on calendar {calendar_id} for grant {grant_id}.
        slots:
          title: query.title
          calendar_id: query.calendar_id
          grant_id: path.grant_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v3/grants/{grant_id}/events'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a calendar event
      effect: write
      questions:
      - How do I put a new meeting on someone's calendar?
      - Can I add participants and conferencing details when creating an event?
      - Will participants get notified when a new event is created?
      instructions:
      - text: Create an event {title} on calendar {calendar_id} for {grant_id} at {when}.
        slots:
          title: requestBody.title
          calendar_id: query.calendar_id
          grant_id: path.grant_id
          when: requestBody.when
      - text: Schedule a meeting on {calendar_id} in {grant_id} at {when} and invite {participants}.
        slots:
          calendar_id: query.calendar_id
          grant_id: path.grant_id
          when: requestBody.when
          participants: requestBody.participants
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v3/grants/{grant_id}/events/import'].get
  update:
    x-apievangelist-phrasing:
      intent: Import all events from a calendar for syncing
      effect: read
      questions:
      - What's the best way to pull every event, including recurring exceptions, into my own database?
      - Can I import a calendar's events for a time frame to sync them to my app?
      instructions:
      - text: Import events from calendar {calendar_id} for grant {grant_id}.
        slots:
          calendar_id: query.calendar_id
          grant_id: path.grant_id
      - text: Import every event on {calendar_id} in {grant_id} from {start} to {end} for sync.
        slots:
          calendar_id: query.calendar_id
          grant_id: path.grant_id
          start: query.start
          end: query.end
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v3/grants/{grant_id}/events/{event_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Retrieve a single calendar event
      effect: read
      questions:
      - How can I get the details of one specific calendar event?
      - Can I fetch a single event by ID to check its time and participants?
      instructions:
      - text: Get event {event_id} from calendar {calendar_id} for {grant_id}.
        slots:
          event_id: path.event_id
          calendar_id: query.calendar_id
          grant_id: path.grant_id
      - text: Show the details of meeting {event_id} on {calendar_id} in grant {grant_id}.
        slots:
          event_id: path.event_id
          calendar_id: query.calendar_id
          grant_id: path.grant_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v3/grants/{grant_id}/events/{event_id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update or reschedule a calendar event
      effect: write
      questions:
      - How do I reschedule an existing calendar event to a new time?
      - Can I change the title or location of an event that's already on the calendar?
      instructions:
      - text: Move event {event_id} on {calendar_id} in {grant_id} to {when}.
        slots:
          event_id: path.event_id
          calendar_id: query.calendar_id
          grant_id: path.grant_id
          when: requestBody.when
      - text: Change the location of event {event_id} on {calendar_id} for {grant_id} to {location}, keeping it at {when}.
        slots:
          event_id: path.event_id
          calendar_id: query.calendar_id
          grant_id: path.grant_id
          location: requestBody.location
          when: requestBody.when
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v3/grants/{grant_id}/events/{event_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a calendar event
      effect: destructive
      questions:
      - How do I remove a meeting from a user's calendar?
      - Can I delete an event without notifying the participants?
      instructions:
      - text: Delete event {event_id} from calendar {calendar_id} for {grant_id}.
        slots:
          event_id: path.event_id
          calendar_id: query.calendar_id
          grant_id: path.grant_id
      - text: Remove meeting {event_id} on {calendar_id} in grant {grant_id} without notifying anyone.
        slots:
          event_id: path.event_id
          calendar_id: query.calendar_id
          grant_id: path.grant_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v3/grants/{grant_id}/events/{event_id}/send-rsvp'].post
  update:
    x-apievangelist-phrasing:
      intent: Respond yes, no or maybe to an event invite
      effect: write
      questions:
      - How do I accept or decline a meeting invitation on a user's behalf?
      - Can I RSVP maybe to an event I've been invited to?
      instructions:
      - text: RSVP {status} to event {event_id} on calendar {calendar_id} for {grant_id}.
        slots:
          status: requestBody.status
          event_id: path.event_id
          calendar_id: query.calendar_id
          grant_id: path.grant_id
      - text: Decline invite {event_id} on {calendar_id} for grant {grant_id}.
        slots:
          event_id: path.event_id
          calendar_id: query.calendar_id
          grant_id: path.grant_id
      method: generated
      generated: '2026-09-26'