# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Gotowebinar Sessions API
  version: 1.0.0
extends: openapi/gotowebinar-sessions-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: 7
- target: $.paths['/organizers/{organizerKey}/sessions'].get
  update:
    x-apievangelist-phrasing:
      intent: List an organizer's completed sessions
      effect: read
      questions:
      - Which webinar sessions has an organizer completed over the last quarter?
      - Can I see all finished sessions across every webinar an organizer runs, for a date range?
      instructions:
      - text: List completed sessions for organizer {organizerKey} between {fromTime} and {toTime}.
        slots:
          organizerKey: path.organizerKey
          fromTime: query.fromTime
          toTime: query.toTime
      - text: Show page {page} of organizer {organizerKey}'s sessions held from {fromTime} to {toTime}.
        slots:
          page: query.page
          organizerKey: path.organizerKey
          fromTime: query.fromTime
          toTime: query.toTime
      method: generated
      generated: '2026-10-01'
- target: $.paths['/organizers/{organizerKey}/webinars/{webinarKey}/sessions'].get
  update:
    x-apievangelist-phrasing:
      intent: List past sessions of one webinar
      effect: read
      questions:
      - How many times has my recurring GoTo Webinar series actually run?
      - Where do I find every past session of a single webinar?
      instructions:
      - text: List the past sessions of webinar {webinarKey} for organizer {organizerKey}.
        slots:
          webinarKey: path.webinarKey
          organizerKey: path.organizerKey
      - text: Show the sessions webinar {webinarKey} has already held.
        slots:
          webinarKey: path.webinarKey
      method: generated
      generated: '2026-10-01'
- target: $.paths['/organizers/{organizerKey}/webinars/{webinarKey}/sessions/{sessionKey}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get attendance details for an ended session
      effect: read
      questions:
      - How many registrants attended a particular session that has ended?
      - Can I see how long each person stayed in a finished session?
      instructions:
      - text: Get session {sessionKey} of webinar {webinarKey} for organizer {organizerKey}.
        slots:
          sessionKey: path.sessionKey
          webinarKey: path.webinarKey
          organizerKey: path.organizerKey
      - text: Show the attendance summary for ended session {sessionKey}.
        slots:
          sessionKey: path.sessionKey
      method: generated
      generated: '2026-10-01'
- target: $.paths['/organizers/{organizerKey}/webinars/{webinarKey}/sessions/{sessionKey}/performance'].get
  update:
    x-apievangelist-phrasing:
      intent: Get performance metrics for a session
      effect: read
      questions:
      - How well did one specific session of my webinar perform?
      - What engagement and performance numbers are available for a single session?
      instructions:
      - text: Get performance details for session {sessionKey} of webinar {webinarKey} for organizer {organizerKey}.
        slots:
          sessionKey: path.sessionKey
          webinarKey: path.webinarKey
          organizerKey: path.organizerKey
      - text: Report how session {sessionKey} performed.
        slots:
          sessionKey: path.sessionKey
      method: generated
      generated: '2026-10-01'
- target: $.paths['/organizers/{organizerKey}/webinars/{webinarKey}/sessions/{sessionKey}/polls'].get
  update:
    x-apievangelist-phrasing:
      intent: Get collated poll answers for a session
      effect: read
      questions:
      - What did the audience vote in the polls during a session?
      - Can I get all poll questions with the attendees' answers collated for one session?
      instructions:
      - text: Get the polls and collated answers from session {sessionKey} of webinar {webinarKey} for organizer {organizerKey}.
        slots:
          sessionKey: path.sessionKey
          webinarKey: path.webinarKey
          organizerKey: path.organizerKey
      - text: Show the poll responses gathered in session {sessionKey}.
        slots:
          sessionKey: path.sessionKey
      method: generated
      generated: '2026-10-01'
- target: $.paths['/organizers/{organizerKey}/webinars/{webinarKey}/sessions/{sessionKey}/questions'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the questions asked in a past session
      effect: read
      questions:
      - Which audience questions came up in a past webinar session and what were the answers?
      - Is the Q&A from a finished session still available afterwards?
      instructions:
      - text: Get the questions and answers for past session {sessionKey} of webinar {webinarKey} for organizer {organizerKey}.
        slots:
          sessionKey: path.sessionKey
          webinarKey: path.webinarKey
          organizerKey: path.organizerKey
      - text: List the audience questions raised in session {sessionKey}.
        slots:
          sessionKey: path.sessionKey
      method: generated
      generated: '2026-10-01'
- target: $.paths['/organizers/{organizerKey}/webinars/{webinarKey}/sessions/{sessionKey}/surveys'].get
  update:
    x-apievangelist-phrasing:
      intent: Get surveys from a past session
      effect: read
      questions:
      - What survey feedback did attendees leave after a session?
      - Can I retrieve the surveys from a session that already ended?
      instructions:
      - text: Get the surveys for past session {sessionKey} of webinar {webinarKey} for organizer {organizerKey}.
        slots:
          sessionKey: path.sessionKey
          webinarKey: path.webinarKey
          organizerKey: path.organizerKey
      - text: Show the survey results from session {sessionKey}.
        slots:
          sessionKey: path.sessionKey
      method: generated
      generated: '2026-10-01'