Webex Admin — Historical Analytics APIs

naftiko: 1.0.0-alpha2
info:
  label: Webex Admin — Historical Analytics APIs
  description: 'Webex Admin — Historical Analytics APIs. 3 operations. Lead operation: Historical Data related to Meetings.
    Self-contained Naftiko capability covering one Webex business surface.'
  tags:
  - Webex
  - Historical Analytics APIs
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    WEBEX_API_KEY: WEBEX_API_KEY
capability:
  consumes:
  - type: http
    namespace: admin-historical-analytics-apis
    baseUri: ''
    description: Webex Admin — Historical Analytics APIs business capability. Self-contained, no shared references.
    resources:
    - name: v1-analytics-meetingsMetrics-aggregates
      path: /v1/analytics/meetingsMetrics/aggregates
      operations:
      - name: historicaldatarelatedtomeetings
        method: GET
        description: Historical Data related to Meetings
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: siteUrl
          in: query
          type: string
          description: URL of the Webex site for which historical data is requested.
          required: true
        - name: from
          in: query
          type: string
          description: UTC Date starting from which the data needs to be returned
        - name: to
          in: query
          type: string
          description: UTC Date up to which the data needs to be returned
    - name: v1-analytics-messagingMetrics-dailyTotals
      path: /v1/analytics/messagingMetrics/dailyTotals
      operations:
      - name: historicaldatarelatedtomessaging
        method: GET
        description: Historical Data related to Messaging
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: from
          in: query
          type: string
          description: UTC date starting from which the data needs to be returned.
        - name: to
          in: query
          type: string
          description: UTC date up to which the data needs to be returned
    - name: v1-analytics-roomDeviceMetrics-dailyTotals
      path: /v1/analytics/roomDeviceMetrics/dailyTotals
      operations:
      - name: historicaldatarelatedtoroomdevices
        method: GET
        description: Historical Data related to Room Devices
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: from
          in: query
          type: string
          description: Starting UTC Date from which historical data should be returned.
        - name: to
          in: query
          type: string
          description: Ending UTC Date for which data should be returned.
    authentication:
      type: bearer
      token: '{{env.WEBEX_API_KEY}}'
  exposes:
  - type: rest
    namespace: admin-historical-analytics-apis-rest
    port: 8080
    description: REST adapter for Webex Admin — Historical Analytics APIs. One Spectral-compliant resource per consumed operation,
      prefixed with /v1.
    resources:
    - path: /v1/v1/analytics/meetingsmetrics/aggregates
      name: v1-analytics-meetingsmetrics-aggregates
      description: REST surface for v1-analytics-meetingsMetrics-aggregates.
      operations:
      - method: GET
        name: historicaldatarelatedtomeetings
        description: Historical Data related to Meetings
        call: admin-historical-analytics-apis.historicaldatarelatedtomeetings
        with:
          siteUrl: rest.siteUrl
          from: rest.from
          to: rest.to
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/analytics/messagingmetrics/dailytotals
      name: v1-analytics-messagingmetrics-dailytotals
      description: REST surface for v1-analytics-messagingMetrics-dailyTotals.
      operations:
      - method: GET
        name: historicaldatarelatedtomessaging
        description: Historical Data related to Messaging
        call: admin-historical-analytics-apis.historicaldatarelatedtomessaging
        with:
          from: rest.from
          to: rest.to
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/analytics/roomdevicemetrics/dailytotals
      name: v1-analytics-roomdevicemetrics-dailytotals
      description: REST surface for v1-analytics-roomDeviceMetrics-dailyTotals.
      operations:
      - method: GET
        name: historicaldatarelatedtoroomdevices
        description: Historical Data related to Room Devices
        call: admin-historical-analytics-apis.historicaldatarelatedtoroomdevices
        with:
          from: rest.from
          to: rest.to
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: admin-historical-analytics-apis-mcp
    port: 9090
    transport: http
    description: MCP adapter for Webex Admin — Historical Analytics APIs. One tool per consumed operation, routed inline through
      this capability's consumes block.
    tools:
    - name: historical-data-related-meetings
      description: Historical Data related to Meetings
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: admin-historical-analytics-apis.historicaldatarelatedtomeetings
      with:
        siteUrl: tools.siteUrl
        from: tools.from
        to: tools.to
      outputParameters:
      - type: object
        mapping: $.
    - name: historical-data-related-messaging
      description: Historical Data related to Messaging
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: admin-historical-analytics-apis.historicaldatarelatedtomessaging
      with:
        from: tools.from
        to: tools.to
      outputParameters:
      - type: object
        mapping: $.
    - name: historical-data-related-room-devices
      description: Historical Data related to Room Devices
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: admin-historical-analytics-apis.historicaldatarelatedtoroomdevices
      with:
        from: tools.from
        to: tools.to
      outputParameters:
      - type: object
        mapping: $.