# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Gotowebinar Attendees API
  version: 1.0.0
extends: openapi/gotowebinar-attendees-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: 6
- target: $.paths['/organizers/{organizerKey}/webinars/{webinarKey}/sessions/{sessionKey}/attendees'].get
  update:
    x-apievangelist-phrasing:
      intent: List who attended one webinar session
      effect: read
      questions:
      - Who actually showed up to a specific session of my GoTo Webinar event?
      - Can I pull the attendee list for just one session rather than the whole webinar?
      instructions:
      - text: List the attendees of session {sessionKey} of webinar {webinarKey} for organizer {organizerKey}.
        slots:
          sessionKey: path.sessionKey
          webinarKey: path.webinarKey
          organizerKey: path.organizerKey
      - text: Show me who joined session {sessionKey} of webinar {webinarKey}.
        slots:
          sessionKey: path.sessionKey
          webinarKey: path.webinarKey
      method: generated
      generated: '2026-10-01'
- target: $.paths['/organizers/{organizerKey}/webinars/{webinarKey}/sessions/{sessionKey}/attendees/{registrantKey}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one attendee's details for a session
      effect: read
      questions:
      - What registration details are kept for a single person who attended a session?
      - Can I look up one specific attendee of a past webinar session by their registrant key?
      instructions:
      - text: Get attendee {registrantKey} from session {sessionKey} of webinar {webinarKey} for organizer {organizerKey}.
        slots:
          registrantKey: path.registrantKey
          sessionKey: path.sessionKey
          webinarKey: path.webinarKey
          organizerKey: path.organizerKey
      - text: Pull the attendance record for registrant {registrantKey} in session {sessionKey}.
        slots:
          registrantKey: path.registrantKey
          sessionKey: path.sessionKey
      method: generated
      generated: '2026-10-01'
- target: $.paths['/organizers/{organizerKey}/webinars/{webinarKey}/sessions/{sessionKey}/attendees/{registrantKey}/polls'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one attendee's poll answers
      effect: read
      questions:
      - How did a particular attendee vote in the polls during a session?
      - Is there a way to see poll responses from just one attendee instead of the session totals?
      instructions:
      - text: Get the poll answers attendee {registrantKey} gave in session {sessionKey} of webinar {webinarKey} for organizer {organizerKey}.
        slots:
          registrantKey: path.registrantKey
          sessionKey: path.sessionKey
          webinarKey: path.webinarKey
          organizerKey: path.organizerKey
      - text: Show how attendee {registrantKey} answered the polls in session {sessionKey}.
        slots:
          registrantKey: path.registrantKey
          sessionKey: path.sessionKey
      method: generated
      generated: '2026-10-01'
- target: $.paths['/organizers/{organizerKey}/webinars/{webinarKey}/sessions/{sessionKey}/attendees/{registrantKey}/questions'].get
  update:
    x-apievangelist-phrasing:
      intent: Get questions one attendee asked in a session
      effect: read
      questions:
      - What questions did a specific attendee type in during the webinar session?
      - Can I see only the questions asked by one person in a session?
      instructions:
      - text: List the questions attendee {registrantKey} asked in session {sessionKey} of webinar {webinarKey} for organizer {organizerKey}.
        slots:
          registrantKey: path.registrantKey
          sessionKey: path.sessionKey
          webinarKey: path.webinarKey
          organizerKey: path.organizerKey
      - text: Show the questions registrant {registrantKey} submitted during session {sessionKey}.
        slots:
          registrantKey: path.registrantKey
          sessionKey: path.sessionKey
      method: generated
      generated: '2026-10-01'
- target: $.paths['/organizers/{organizerKey}/webinars/{webinarKey}/sessions/{sessionKey}/attendees/{registrantKey}/surveys'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one attendee's survey answers
      effect: read
      questions:
      - How did a particular attendee fill out the session survey?
      - Where do I find one attendee's survey responses from a webinar session?
      instructions:
      - text: Get the survey answers from attendee {registrantKey} in session {sessionKey} of webinar {webinarKey} for organizer {organizerKey}.
        slots:
          registrantKey: path.registrantKey
          sessionKey: path.sessionKey
          webinarKey: path.webinarKey
          organizerKey: path.organizerKey
      - text: Show what attendee {registrantKey} answered on the survey in session {sessionKey}.
        slots:
          registrantKey: path.registrantKey
          sessionKey: path.sessionKey
      method: generated
      generated: '2026-10-01'
- target: $.paths['/organizers/{organizerKey}/webinars/{webinarKey}/attendees'].get
  update:
    x-apievangelist-phrasing:
      intent: List attendees across every session of a webinar
      effect: read
      questions:
      - Who attended any session of my webinar, across all of its sessions combined?
      - Can I get one attendee list covering a whole webinar series instead of session by session?
      instructions:
      - text: List every attendee across all sessions of webinar {webinarKey} for organizer {organizerKey}.
        slots:
          webinarKey: path.webinarKey
          organizerKey: path.organizerKey
      - text: Give me the combined attendee list for webinar {webinarKey}, all sessions included.
        slots:
          webinarKey: path.webinarKey
      method: generated
      generated: '2026-10-01'