Webex Meetings — Meeting Polls

naftiko: 1.0.0-alpha2
info:
  label: Webex Meetings — Meeting Polls
  description: 'Webex Meetings — Meeting Polls. 3 operations. Lead operation: Get Meeting PollResults. Self-contained Naftiko
    capability covering one Webex business surface.'
  tags:
  - Webex
  - Meeting Polls
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    WEBEX_API_KEY: WEBEX_API_KEY
capability:
  consumes:
  - type: http
    namespace: meeting-meeting-polls
    baseUri: ''
    description: Webex Meetings — Meeting Polls business capability. Self-contained, no shared references.
    resources:
    - name: meetings-pollResults
      path: /meetings/pollResults
      operations:
      - name: getmeetingpollresults
        method: GET
        description: Get Meeting PollResults
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: meetingId
          in: query
          type: string
          description: A unique identifier for the [meeting instance](/docs/meetings#meeting-series-scheduled-meetings-and-meeting-instances)
            to which the polls belong.
          required: true
        - name: max
          in: query
          type: number
          description: Limit the maximum number of respondents in a meeting in the response, up to 100.
    - name: meetings-polls
      path: /meetings/polls
      operations:
      - name: listmeetingpolls
        method: GET
        description: List Meeting Polls
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: meetingId
          in: query
          type: string
          description: A unique identifier for the [meeting instance](/docs/meetings#meeting-series-scheduled-meetings-and-meeting-instances)
            to which the polls belong.
          required: true
    - name: meetings-polls-pollId-questions-questionId-respondents
      path: /meetings/polls/{pollId}/questions/{questionId}/respondents
      operations:
      - name: listrespondentsofaquestion
        method: GET
        description: List Respondents of a Question
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: pollId
          in: path
          type: string
          description: A unique identifier for the poll to which the respondents belong.
          required: true
        - name: questionId
          in: path
          type: string
          description: A unique identifier for the question to which the respondents belong.
          required: true
        - name: meetingId
          in: query
          type: string
          description: A unique identifier for the [meeting instance](/docs/meetings#meeting-series-scheduled-meetings-and-meeting-instances)
            to which the respondents belong.
          required: true
        - name: max
          in: query
          type: number
          description: Limit the maximum number of respondents in a specified question in the response, up to 100.
    authentication:
      type: bearer
      token: '{{env.WEBEX_API_KEY}}'
  exposes:
  - type: rest
    namespace: meeting-meeting-polls-rest
    port: 8080
    description: REST adapter for Webex Meetings — Meeting Polls. One Spectral-compliant resource per consumed operation,
      prefixed with /v1.
    resources:
    - path: /v1/meetings/pollresults
      name: meetings-pollresults
      description: REST surface for meetings-pollResults.
      operations:
      - method: GET
        name: getmeetingpollresults
        description: Get Meeting PollResults
        call: meeting-meeting-polls.getmeetingpollresults
        with:
          meetingId: rest.meetingId
          max: rest.max
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/meetings/polls
      name: meetings-polls
      description: REST surface for meetings-polls.
      operations:
      - method: GET
        name: listmeetingpolls
        description: List Meeting Polls
        call: meeting-meeting-polls.listmeetingpolls
        with:
          meetingId: rest.meetingId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/meetings/polls/{pollid}/questions/{questionid}/respondents
      name: meetings-polls-pollid-questions-questionid-respondents
      description: REST surface for meetings-polls-pollId-questions-questionId-respondents.
      operations:
      - method: GET
        name: listrespondentsofaquestion
        description: List Respondents of a Question
        call: meeting-meeting-polls.listrespondentsofaquestion
        with:
          pollId: rest.pollId
          questionId: rest.questionId
          meetingId: rest.meetingId
          max: rest.max
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: meeting-meeting-polls-mcp
    port: 9090
    transport: http
    description: MCP adapter for Webex Meetings — Meeting Polls. One tool per consumed operation, routed inline through this
      capability's consumes block.
    tools:
    - name: get-meeting-pollresults
      description: Get Meeting PollResults
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: meeting-meeting-polls.getmeetingpollresults
      with:
        meetingId: tools.meetingId
        max: tools.max
      outputParameters:
      - type: object
        mapping: $.
    - name: list-meeting-polls
      description: List Meeting Polls
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: meeting-meeting-polls.listmeetingpolls
      with:
        meetingId: tools.meetingId
      outputParameters:
      - type: object
        mapping: $.
    - name: list-respondents-question
      description: List Respondents of a Question
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: meeting-meeting-polls.listrespondentsofaquestion
      with:
        pollId: tools.pollId
        questionId: tools.questionId
        meetingId: tools.meetingId
        max: tools.max
      outputParameters:
      - type: object
        mapping: $.