Webex Cloud Calling — Reports: Detailed Call History

naftiko: 1.0.0-alpha2
info:
  label: 'Webex Cloud Calling — Reports: Detailed Call History'
  description: 'Webex Cloud Calling — Reports: Detailed Call History. 2 operations. Lead operation: Get Detailed Call History.
    Self-contained Naftiko capability covering one Webex business surface.'
  tags:
  - Webex
  - 'Reports: Detailed Call History'
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    WEBEX_API_KEY: WEBEX_API_KEY
capability:
  consumes:
  - type: http
    namespace: cloud-calling-reports-detailed-call-history
    baseUri: ''
    description: 'Webex Cloud Calling — Reports: Detailed Call History business capability. Self-contained, no shared references.'
    resources:
    - name: cdr_feed
      path: /cdr_feed
      operations:
      - name: getdetailedcallhistory
        method: GET
        description: Get Detailed Call History
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: startTime
          in: query
          type: string
          description: Time of the first report you wish to collect. (Report time is the time the call finished). **Note:**
            The specified time must be between 5 minutes ago and 48 hou
          required: true
        - name: endTime
          in: query
          type: string
          description: Time of the last report you wish to collect. (Report time is the time the call finished). **Note:**
            The specified time should be later than `startTime` but no l
          required: true
        - name: locations
          in: query
          type: string
          description: Name of the location (as shown in Control Hub). Up to 10 comma-separated locations can be provided.
            Allows you to query reports by location.
        - name: max
          in: query
          type: number
          description: 'Limit the maximum number of reports per page of the response. The range is 500 to 5000. Values below
            500 are automatically adjusted up to 500, and values above '
    - name: cdr_stream
      path: /cdr_stream
      operations:
      - name: getlivestreamdetailedcallhistory
        method: GET
        description: Get Live Stream Detailed Call History
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: startTime
          in: query
          type: string
          description: The start date-time of the first record you wish to collect in UTC time. It would be the earliest time
            at which the data was inserted into the Webex Calling clo
          required: true
        - name: endTime
          in: query
          type: string
          description: The end date-time of the last record you wish to collect in UTC time. It would be the latest time at
            which the data was inserted into the Webex Calling cloud fo
          required: true
        - name: locations
          in: query
          type: string
          description: Name of the location (as shown in Control Hub). Up to 10 comma-separated locations can be provided.
            Allows you to query reports by location.
        - name: max
          in: query
          type: number
          description: 'Limit the maximum number of reports per page of the response. The range is 500 to 5000. Values below
            500 are automatically adjusted up to 500, and values above '
    authentication:
      type: bearer
      token: '{{env.WEBEX_API_KEY}}'
  exposes:
  - type: rest
    namespace: cloud-calling-reports-detailed-call-history-rest
    port: 8080
    description: 'REST adapter for Webex Cloud Calling — Reports: Detailed Call History. One Spectral-compliant resource per
      consumed operation, prefixed with /v1.'
    resources:
    - path: /v1/cdr-feed
      name: cdr-feed
      description: REST surface for cdr_feed.
      operations:
      - method: GET
        name: getdetailedcallhistory
        description: Get Detailed Call History
        call: cloud-calling-reports-detailed-call-history.getdetailedcallhistory
        with:
          startTime: rest.startTime
          endTime: rest.endTime
          locations: rest.locations
          max: rest.max
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/cdr-stream
      name: cdr-stream
      description: REST surface for cdr_stream.
      operations:
      - method: GET
        name: getlivestreamdetailedcallhistory
        description: Get Live Stream Detailed Call History
        call: cloud-calling-reports-detailed-call-history.getlivestreamdetailedcallhistory
        with:
          startTime: rest.startTime
          endTime: rest.endTime
          locations: rest.locations
          max: rest.max
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: cloud-calling-reports-detailed-call-history-mcp
    port: 9090
    transport: http
    description: 'MCP adapter for Webex Cloud Calling — Reports: Detailed Call History. One tool per consumed operation, routed
      inline through this capability''s consumes block.'
    tools:
    - name: get-detailed-call-history
      description: Get Detailed Call History
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: cloud-calling-reports-detailed-call-history.getdetailedcallhistory
      with:
        startTime: tools.startTime
        endTime: tools.endTime
        locations: tools.locations
        max: tools.max
      outputParameters:
      - type: object
        mapping: $.
    - name: get-live-stream-detailed-call
      description: Get Live Stream Detailed Call History
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: cloud-calling-reports-detailed-call-history.getlivestreamdetailedcallhistory
      with:
        startTime: tools.startTime
        endTime: tools.endTime
        locations: tools.locations
        max: tools.max
      outputParameters:
      - type: object
        mapping: $.