# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Zoom / Account Meeting Polls API
  version: 1.0.0
extends: openapi/zoom-meeting-polls-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-24'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 5
- target: $.paths['/meetings/{meetingId}/polls'].get
  update:
    x-apievangelist-phrasing:
      intent: List a meeting's polls
      effect: read
      questions:
      - What polls are set up for a meeting?
      - Can I list only the anonymous polls on a meeting?
      instructions:
      - text: List the polls for meeting {meetingId}.
        slots:
          meetingId: path.meetingId
      - text: List polls on meeting {meetingId} filtered by anonymous = {anonymous}.
        slots:
          meetingId: path.meetingId
          anonymous: query.anonymous
      method: generated
      generated: '2026-09-24'
- target: $.paths['/meetings/{meetingId}/polls'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a poll for a scheduled meeting
      effect: write
      questions:
      - How do I add a poll to a meeting ahead of time?
      - Why can't I add a poll to an instant meeting?
      - Can I make a new poll anonymous?
      instructions:
      - text: Create a poll titled {title} for meeting {meetingId}.
        slots:
          title: requestBody.title
          meetingId: path.meetingId
      - text: Add poll {title} with anonymous set to {anonymous} and questions {questions} to meeting {meetingId}.
        slots:
          title: requestBody.title
          anonymous: requestBody.anonymous
          questions: requestBody.questions
          meetingId: path.meetingId
      method: generated
      generated: '2026-09-24'
- target: $.paths['/meetings/{meetingId}/polls/{pollId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a meeting poll's details
      effect: read
      questions:
      - What questions are in a specific poll on my meeting?
      - Can I view one poll by its ID?
      instructions:
      - text: Get poll {pollId} on meeting {meetingId}.
        slots:
          pollId: path.pollId
          meetingId: path.meetingId
      - text: Show the questions in poll {pollId} for meeting {meetingId}.
        slots:
          pollId: path.pollId
          meetingId: path.meetingId
      method: generated
      generated: '2026-09-24'
- target: $.paths['/meetings/{meetingId}/polls/{pollId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a meeting poll
      effect: write
      questions:
      - Can I edit the questions of a poll I already created?
      - Is it possible to switch an existing poll to anonymous?
      instructions:
      - text: Rename poll {pollId} on meeting {meetingId} to {title}.
        slots:
          pollId: path.pollId
          meetingId: path.meetingId
          title: requestBody.title
      - text: Replace the questions in existing poll {pollId} of meeting {meetingId} with {questions}.
        slots:
          pollId: path.pollId
          meetingId: path.meetingId
          questions: requestBody.questions
      method: generated
      generated: '2026-09-24'
- target: $.paths['/meetings/{meetingId}/polls/{pollId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a meeting poll
      effect: destructive
      questions:
      - Can I remove a poll from a meeting?
      - What happens to a poll once it's deleted from a meeting?
      instructions:
      - text: Delete poll {pollId} from meeting {meetingId}.
        slots:
          pollId: path.pollId
          meetingId: path.meetingId
      - text: Remove the poll {pollId} on meeting {meetingId}.
        slots:
          pollId: path.pollId
          meetingId: path.meetingId
      method: generated
      generated: '2026-09-24'