Webex Meetings — Meeting Q and A

naftiko: 1.0.0-alpha2
info:
  label: Webex Meetings — Meeting Q and A
  description: 'Webex Meetings — Meeting Q and A. 2 operations. Lead operation: List Meeting Q and A. Self-contained Naftiko
    capability covering one Webex business surface.'
  tags:
  - Webex
  - Meeting Q and A
  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-q-and-a
    baseUri: ''
    description: Webex Meetings — Meeting Q and A business capability. Self-contained, no shared references.
    resources:
    - name: meetings-q_and_a
      path: /meetings/q_and_a
      operations:
      - name: listmeetingqanda
        method: GET
        description: List Meeting Q and A
        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)
            which the Q&A belongs to.
          required: true
        - name: max
          in: query
          type: number
          description: Limits the maximum number of answers in the response, up to 100.
    - name: meetings-q_and_a-questionId-answers
      path: /meetings/q_and_a/{questionId}/answers
      operations:
      - name: listanswersofaquestion
        method: GET
        description: List Answers of a Question
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: questionId
          in: path
          type: string
          description: The ID of a question.
          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)
            which the Q&A belongs to.
          required: true
        - name: max
          in: query
          type: number
          description: Limit the maximum number of Q&A's answers in the response, up to 100.
    authentication:
      type: bearer
      token: '{{env.WEBEX_API_KEY}}'
  exposes:
  - type: rest
    namespace: meeting-meeting-q-and-a-rest
    port: 8080
    description: REST adapter for Webex Meetings — Meeting Q and A. One Spectral-compliant resource per consumed operation,
      prefixed with /v1.
    resources:
    - path: /v1/meetings/q-and-a
      name: meetings-q-and-a
      description: REST surface for meetings-q_and_a.
      operations:
      - method: GET
        name: listmeetingqanda
        description: List Meeting Q and A
        call: meeting-meeting-q-and-a.listmeetingqanda
        with:
          meetingId: rest.meetingId
          max: rest.max
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/meetings/q-and-a/{questionid}/answers
      name: meetings-q-and-a-questionid-answers
      description: REST surface for meetings-q_and_a-questionId-answers.
      operations:
      - method: GET
        name: listanswersofaquestion
        description: List Answers of a Question
        call: meeting-meeting-q-and-a.listanswersofaquestion
        with:
          questionId: rest.questionId
          meetingId: rest.meetingId
          max: rest.max
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: meeting-meeting-q-and-a-mcp
    port: 9090
    transport: http
    description: MCP adapter for Webex Meetings — Meeting Q and A. One tool per consumed operation, routed inline through
      this capability's consumes block.
    tools:
    - name: list-meeting-q-and
      description: List Meeting Q and A
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: meeting-meeting-q-and-a.listmeetingqanda
      with:
        meetingId: tools.meetingId
        max: tools.max
      outputParameters:
      - type: object
        mapping: $.
    - name: list-answers-question
      description: List Answers of a Question
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: meeting-meeting-q-and-a.listanswersofaquestion
      with:
        questionId: tools.questionId
        meetingId: tools.meetingId
        max: tools.max
      outputParameters:
      - type: object
        mapping: $.