naftiko: 1.0.0-alpha2 info: label: Coveo Usage Analytics Read API — Statistics API - Version 15 description: 'Coveo Usage Analytics Read API — Statistics API - Version 15. 11 operations. Lead operation: Get Metrics Combined with Dimensions for a Date Range. Self-contained Naftiko capability covering one Coveo business surface.' tags: - Coveo - Usage Analytics Read - Statistics API - Version 15 created: '2026-05-19' modified: '2026-05-19' binds: - namespace: env keys: COVEO_API_KEY: COVEO_API_KEY capability: consumes: - type: http namespace: usage-analytics-read-statistics-api-version-15 baseUri: https://analytics.cloud.coveo.com/rest/ua description: Coveo Usage Analytics Read API — Statistics API - Version 15 business capability. Self-contained, no shared references. authentication: type: bearer token: '{{env.COVEO_API_KEY}}' resources: - name: v15-stats-combinedData path: /v15/stats/combinedData operations: - name: getv15statscombineddata method: GET description: Get Metrics Combined with Dimensions for a Date Range outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: m in: query type: array description: The metrics to fetch. required: true - name: from in: query type: string description: The beginning date of the date range. ISO8601 format 'YYYY-MM-DDThh:mm:ss.sssZ' required: true - name: to in: query type: string description: The end date of the date range. ISO8601 format 'YYYY-MM-DDThh:mm:ss.sssZ' required: true - name: tz in: query type: string description: Timezone used for calculations. - name: d in: query type: array description: The dimensions to fetch. required: true - name: f in: query type: array description: The filter that will be applied to the events dimensions. Multiple filter parameters are joined with the AND operator. - name: fm in: query type: array description: The filter that will be applied to the metrics. Multiple filter parameters are joined with the AND operator. - name: s in: query type: string description: The field to order the results by. It must be a dimension, metric or custom dimension that was specified in the 'm' or the 'd' parameter. - name: p in: query type: integer description: The response's page to access, starting at 1. - name: n in: query type: integer description: The number of results to include in a page. - name: asc in: query type: boolean description: Whether to sort by ascending order. - name: includeMetadata in: query type: boolean description: Whether to include metadata regarding the results (total count and unique counts, if applicable). - name: format in: query type: string description: The format of the response. Default is JSON. - name: bindOnLastSearch in: query type: boolean description: bindOnLastSearch - name: org in: query type: string description: The name of the organization (Coveo Cloud V2 only) - name: v15-stats-globalData path: /v15/stats/globalData operations: - name: getv15statsglobaldata method: GET description: Get Global Data for Each Metric for a Date Range outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: m in: query type: array description: The metrics to fetch. required: true - name: from in: query type: string description: The beginning date of the date range. ISO8601 format 'YYYY-MM-DDThh:mm:ss.sssZ' required: true - name: to in: query type: string description: The end date of the date range. ISO8601 format 'YYYY-MM-DDThh:mm:ss.sssZ' required: true - name: tz in: query type: string description: Timezone used for calculations. - name: d in: query type: array description: The dimensions to fetch. Required when the Activity metric is requested as it has to be based on a dimension. - name: f in: query type: array description: The filter that will be applied to the events dimensions. Multiple filter parameters are joined with the AND operator. - name: i in: query type: string description: The interval on which data will be grouped. Default value is DAY. - name: bindOnLastSearch in: query type: boolean description: bindOnLastSearch - name: org in: query type: string description: The name of the organization (Coveo Cloud V2 only) - name: v15-stats-graphDataPoints path: /v15/stats/graphDataPoints operations: - name: getv15statsgraphdatapoints method: GET description: Get Graph Data Points for the Metrics for a Date Range outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: m in: query type: array description: The metrics to fetch. required: true - name: from in: query type: string description: The beginning date of the date range. ISO8601 format 'YYYY-MM-DDThh:mm:ss.sssZ' required: true - name: to in: query type: string description: The end date of the date range. ISO8601 format 'YYYY-MM-DDThh:mm:ss.sssZ' required: true - name: tz in: query type: string description: Timezone used for calculations. - name: f in: query type: array description: The filter that will be applied to the events dimensions. Multiple filter parameters are joined with the AND operator. - name: i in: query type: string description: The interval on which data will be grouped. Default value is DAY. - name: bindOnLastSearch in: query type: boolean description: bindOnLastSearch - name: org in: query type: string description: The name of the organization (Coveo Cloud V2 only) - name: v15-stats-monitoring-health path: /v15/stats/monitoring/health operations: - name: getv15statsmonitoringhealth method: GET description: Health Check for the Statistics Service outputRawFormat: json outputParameters: - name: result type: object value: $. - name: v15-stats-query-queryId path: /v15/stats/query/{queryId} operations: - name: deletev15statsqueryqueryid method: DELETE description: Cancel the Execution of a Query outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: org in: query type: string description: The name of the organization (Coveo Cloud V2 only) - name: v15-stats-status path: /v15/stats/status operations: - name: getv15statsstatus method: GET description: Get the Statistics Service Status outputRawFormat: json outputParameters: - name: result type: object value: $. - name: v15-stats-trends path: /v15/stats/trends operations: - name: getv15statstrends method: GET description: Get Trends of a Metric Combined with Dimensions for a Date Range outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: m in: query type: array description: The metrics to fetch. required: true - name: from in: query type: string description: The beginning date of the date range. ISO8601 format 'YYYY-MM-DDThh:mm:ss.sssZ' required: true - name: to in: query type: string description: The end date of the date range. ISO8601 format 'YYYY-MM-DDThh:mm:ss.sssZ' required: true - name: previousFrom in: query type: string description: The beginning date of the previous date range, when reporting trends. ISO8601 format 'YYYY-MM-DDThh:mm:ss.sssZ'. If not specified, it will be the 'from' date mi - name: previousTo in: query type: string description: 'The end date of the previous date range, when reporting trends. ISO8601 format ''YYYY-MM-DDThh:mm:ss.sssZ''. If not specified, it will be the ''to'' date minus the ' - name: tz in: query type: string description: Timezone used for calculations. - name: d in: query type: array description: The dimensions to fetch. required: true - name: f in: query type: array description: The filter that will be applied to the events dimensions. Multiple filter parameters are joined with the AND operator. - name: fm in: query type: array description: The filter that will be applied to the metrics. Multiple filter parameters are joined with the AND operator. - name: s in: query type: string description: The field to order the results by. It must be a dimension, metric or custom dimension that was specified in the 'm' or the 'd' parameter. - name: p in: query type: integer description: The response's page to access, starting at 1. - name: n in: query type: integer description: The number of results to include in a page. - name: asc in: query type: boolean description: Whether to sort by ascending order. - name: includeMetadata in: query type: boolean description: Whether to include metadata regarding the results (total count and unique counts, if applicable). - name: format in: query type: string description: The format of the response. Default is JSON. - name: bindOnLastSearch in: query type: boolean description: bindOnLastSearch - name: t in: query type: array description: The trends to caculate. required: true - name: org in: query type: string description: The name of the organization (Coveo Cloud V2 only) - name: v15-stats-visits path: /v15/stats/visits operations: - name: getv15statsvisits method: GET description: Get the Details of the Visits Matching the Specified Criteria outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: from in: query type: string description: The beginning date of the date range. ISO8601 format 'YYYY-MM-DDThh:mm:ss.sssZ' required: true - name: to in: query type: string description: The end date of the date range. ISO8601 format 'YYYY-MM-DDThh:mm:ss.sssZ' required: true - name: tz in: query type: string description: Timezone used for calculations. - name: d in: query type: array description: The dimensions to fetch. - name: f in: query type: array description: The filter that will be applied to the events dimensions. Multiple filter parameters are joined with the AND operator. - name: hideEventFilters in: query type: array description: Each specified filter is inverted in order to hide events. Multiple filter parameters are joined with the AND operator. - name: fn in: query type: array description: The filter that will be applied to dimensions to exclude events from the results. Multiple filter parameters are joined with the AND operator. - name: s in: query type: string description: The field to order the results by. It must be a dimension, metric or custom dimension that was specified in the 'm' or the 'd' parameter. - name: p in: query type: integer description: The response's page to access, starting at 1. - name: n in: query type: integer description: The number of results to include in a page. - name: asc in: query type: boolean description: Whether to sort by ascending order. - name: includeMetadata in: query type: boolean description: Whether to include metadata regarding the results (total count and unique counts, if applicable). - name: org in: query type: string description: The name of the organization (Coveo Cloud V2 only) - name: postv15statsvisits method: POST description: Force a Visit View Update outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: org in: query type: string description: The name of the organization (Coveo Cloud V2 only) - name: v15-stats-visitsGraphDataPoints path: /v15/stats/visitsGraphDataPoints operations: - name: getv15statsvisitsgraphdatapoints method: GET description: Get Graph Data Points for Visit Based Metrics for a Date Range outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: m in: query type: array description: The metrics to fetch. required: true - name: from in: query type: string description: The beginning date of the date range. ISO8601 format 'YYYY-MM-DDThh:mm:ss.sssZ' required: true - name: to in: query type: string description: The end date of the date range. ISO8601 format 'YYYY-MM-DDThh:mm:ss.sssZ' required: true - name: tz in: query type: string description: Timezone used for calculations. - name: f in: query type: array description: The filter that will be applied to the events dimensions. Multiple filter parameters are joined with the AND operator. - name: hideEventFilters in: query type: array description: Each specified filter is inverted in order to hide events. Multiple filter parameters are joined with the AND operator. - name: fn in: query type: array description: The filter that will be applied to dimensions to exclude events from the results. Multiple filter parameters are joined with the AND operator. - name: i in: query type: string description: The interval on which data will be grouped. Default value is DAY. - name: org in: query type: string description: The name of the organization (Coveo Cloud V2 only) - name: v15-stats-visitsMetrics path: /v15/stats/visitsMetrics operations: - name: getv15statsvisitsmetrics method: GET description: Get the Metrics Based on the Visits Matching the Specified Criteria outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: m in: query type: array description: The metrics to fetch. required: true - name: from in: query type: string description: The beginning date of the date range. ISO8601 format 'YYYY-MM-DDThh:mm:ss.sssZ' required: true - name: to in: query type: string description: The end date of the date range. ISO8601 format 'YYYY-MM-DDThh:mm:ss.sssZ' required: true - name: tz in: query type: string description: Timezone used for calculations. - name: f in: query type: array description: The filter that will be applied to the events dimensions. Multiple filter parameters are joined with the AND operator. - name: hideEventFilters in: query type: array description: Each specified filter is inverted in order to hide events. Multiple filter parameters are joined with the AND operator. - name: fn in: query type: array description: The filter that will be applied to dimensions to exclude events from the results. Multiple filter parameters are joined with the AND operator. - name: org in: query type: string description: The name of the organization (Coveo Cloud V2 only) exposes: - type: rest namespace: usage-analytics-read-statistics-api-version-15-rest port: 8080 description: REST adapter for Coveo Usage Analytics Read API — Statistics API - Version 15. One Spectral-compliant resource per consumed operation, prefixed with /v1. resources: - path: /v1/v15/stats/combineddata name: v15-stats-combineddata description: REST surface for v15-stats-combinedData. operations: - method: GET name: getv15statscombineddata description: Get Metrics Combined with Dimensions for a Date Range call: usage-analytics-read-statistics-api-version-15.getv15statscombineddata with: m: rest.m from: rest.from to: rest.to tz: rest.tz d: rest.d f: rest.f fm: rest.fm s: rest.s p: rest.p n: rest.n asc: rest.asc includeMetadata: rest.includeMetadata format: rest.format bindOnLastSearch: rest.bindOnLastSearch org: rest.org outputParameters: - type: object mapping: $. - path: /v1/v15/stats/globaldata name: v15-stats-globaldata description: REST surface for v15-stats-globalData. operations: - method: GET name: getv15statsglobaldata description: Get Global Data for Each Metric for a Date Range call: usage-analytics-read-statistics-api-version-15.getv15statsglobaldata with: m: rest.m from: rest.from to: rest.to tz: rest.tz d: rest.d f: rest.f i: rest.i bindOnLastSearch: rest.bindOnLastSearch org: rest.org outputParameters: - type: object mapping: $. - path: /v1/v15/stats/graphdatapoints name: v15-stats-graphdatapoints description: REST surface for v15-stats-graphDataPoints. operations: - method: GET name: getv15statsgraphdatapoints description: Get Graph Data Points for the Metrics for a Date Range call: usage-analytics-read-statistics-api-version-15.getv15statsgraphdatapoints with: m: rest.m from: rest.from to: rest.to tz: rest.tz f: rest.f i: rest.i bindOnLastSearch: rest.bindOnLastSearch org: rest.org outputParameters: - type: object mapping: $. - path: /v1/v15/stats/monitoring/health name: v15-stats-monitoring-health description: REST surface for v15-stats-monitoring-health. operations: - method: GET name: getv15statsmonitoringhealth description: Health Check for the Statistics Service call: usage-analytics-read-statistics-api-version-15.getv15statsmonitoringhealth outputParameters: - type: object mapping: $. - path: /v1/v15/stats/query/{queryid} name: v15-stats-query-queryid description: REST surface for v15-stats-query-queryId. operations: - method: DELETE name: deletev15statsqueryqueryid description: Cancel the Execution of a Query call: usage-analytics-read-statistics-api-version-15.deletev15statsqueryqueryid with: org: rest.org outputParameters: - type: object mapping: $. - path: /v1/v15/stats/status name: v15-stats-status description: REST surface for v15-stats-status. operations: - method: GET name: getv15statsstatus description: Get the Statistics Service Status call: usage-analytics-read-statistics-api-version-15.getv15statsstatus outputParameters: - type: object mapping: $. - path: /v1/v15/stats/trends name: v15-stats-trends description: REST surface for v15-stats-trends. operations: - method: GET name: getv15statstrends description: Get Trends of a Metric Combined with Dimensions for a Date Range call: usage-analytics-read-statistics-api-version-15.getv15statstrends with: m: rest.m from: rest.from to: rest.to previousFrom: rest.previousFrom previousTo: rest.previousTo tz: rest.tz d: rest.d f: rest.f fm: rest.fm s: rest.s p: rest.p n: rest.n asc: rest.asc includeMetadata: rest.includeMetadata format: rest.format bindOnLastSearch: rest.bindOnLastSearch t: rest.t org: rest.org outputParameters: - type: object mapping: $. - path: /v1/v15/stats/visits name: v15-stats-visits description: REST surface for v15-stats-visits. operations: - method: GET name: getv15statsvisits description: Get the Details of the Visits Matching the Specified Criteria call: usage-analytics-read-statistics-api-version-15.getv15statsvisits with: from: rest.from to: rest.to tz: rest.tz d: rest.d f: rest.f hideEventFilters: rest.hideEventFilters fn: rest.fn s: rest.s p: rest.p n: rest.n asc: rest.asc includeMetadata: rest.includeMetadata org: rest.org outputParameters: - type: object mapping: $. - method: POST name: postv15statsvisits description: Force a Visit View Update call: usage-analytics-read-statistics-api-version-15.postv15statsvisits with: org: rest.org outputParameters: - type: object mapping: $. - path: /v1/v15/stats/visitsgraphdatapoints name: v15-stats-visitsgraphdatapoints description: REST surface for v15-stats-visitsGraphDataPoints. operations: - method: GET name: getv15statsvisitsgraphdatapoints description: Get Graph Data Points for Visit Based Metrics for a Date Range call: usage-analytics-read-statistics-api-version-15.getv15statsvisitsgraphdatapoints with: m: rest.m from: rest.from to: rest.to tz: rest.tz f: rest.f hideEventFilters: rest.hideEventFilters fn: rest.fn i: rest.i org: rest.org outputParameters: - type: object mapping: $. - path: /v1/v15/stats/visitsmetrics name: v15-stats-visitsmetrics description: REST surface for v15-stats-visitsMetrics. operations: - method: GET name: getv15statsvisitsmetrics description: Get the Metrics Based on the Visits Matching the Specified Criteria call: usage-analytics-read-statistics-api-version-15.getv15statsvisitsmetrics with: m: rest.m from: rest.from to: rest.to tz: rest.tz f: rest.f hideEventFilters: rest.hideEventFilters fn: rest.fn org: rest.org outputParameters: - type: object mapping: $. - type: mcp namespace: usage-analytics-read-statistics-api-version-15-mcp port: 9090 transport: http description: MCP adapter for Coveo Usage Analytics Read API — Statistics API - Version 15. One tool per consumed operation, routed inline through this capability's consumes block. tools: - name: get-metrics-combined-dimensions-date description: Get Metrics Combined with Dimensions for a Date Range hints: readOnly: true destructive: false idempotent: true call: usage-analytics-read-statistics-api-version-15.getv15statscombineddata with: m: tools.m from: tools.from to: tools.to tz: tools.tz d: tools.d f: tools.f fm: tools.fm s: tools.s p: tools.p n: tools.n asc: tools.asc includeMetadata: tools.includeMetadata format: tools.format bindOnLastSearch: tools.bindOnLastSearch org: tools.org outputParameters: - type: object mapping: $. - name: get-global-data-each-metric description: Get Global Data for Each Metric for a Date Range hints: readOnly: true destructive: false idempotent: true call: usage-analytics-read-statistics-api-version-15.getv15statsglobaldata with: m: tools.m from: tools.from to: tools.to tz: tools.tz d: tools.d f: tools.f i: tools.i bindOnLastSearch: tools.bindOnLastSearch org: tools.org outputParameters: - type: object mapping: $. - name: get-graph-data-points-metrics description: Get Graph Data Points for the Metrics for a Date Range hints: readOnly: true destructive: false idempotent: true call: usage-analytics-read-statistics-api-version-15.getv15statsgraphdatapoints with: m: tools.m from: tools.from to: tools.to tz: tools.tz f: tools.f i: tools.i bindOnLastSearch: tools.bindOnLastSearch org: tools.org outputParameters: - type: object mapping: $. - name: health-check-statistics-service description: Health Check for the Statistics Service hints: readOnly: true destructive: false idempotent: true call: usage-analytics-read-statistics-api-version-15.getv15statsmonitoringhealth outputParameters: - type: object mapping: $. - name: cancel-execution-query description: Cancel the Execution of a Query hints: readOnly: false destructive: true idempotent: true call: usage-analytics-read-statistics-api-version-15.deletev15statsqueryqueryid with: org: tools.org outputParameters: - type: object mapping: $. - name: get-statistics-service-status description: Get the Statistics Service Status hints: readOnly: true destructive: false idempotent: true call: usage-analytics-read-statistics-api-version-15.getv15statsstatus outputParameters: - type: object mapping: $. - name: get-trends-metric-combined-dimensions description: Get Trends of a Metric Combined with Dimensions for a Date Range hints: readOnly: true destructive: false idempotent: true call: usage-analytics-read-statistics-api-version-15.getv15statstrends with: m: tools.m from: tools.from to: tools.to previousFrom: tools.previousFrom previousTo: tools.previousTo tz: tools.tz d: tools.d f: tools.f fm: tools.fm s: tools.s p: tools.p n: tools.n asc: tools.asc includeMetadata: tools.includeMetadata format: tools.format bindOnLastSearch: tools.bindOnLastSearch t: tools.t org: tools.org outputParameters: - type: object mapping: $. - name: get-details-visits-matching-specified description: Get the Details of the Visits Matching the Specified Criteria hints: readOnly: true destructive: false idempotent: true call: usage-analytics-read-statistics-api-version-15.getv15statsvisits with: from: tools.from to: tools.to tz: tools.tz d: tools.d f: tools.f hideEventFilters: tools.hideEventFilters fn: tools.fn s: tools.s p: tools.p n: tools.n asc: tools.asc includeMetadata: tools.includeMetadata org: tools.org outputParameters: - type: object mapping: $. - name: force-visit-view-update description: Force a Visit View Update hints: readOnly: false destructive: false idempotent: false call: usage-analytics-read-statistics-api-version-15.postv15statsvisits with: org: tools.org outputParameters: - type: object mapping: $. - name: get-graph-data-points-visit description: Get Graph Data Points for Visit Based Metrics for a Date Range hints: readOnly: true destructive: false idempotent: true call: usage-analytics-read-statistics-api-version-15.getv15statsvisitsgraphdatapoints with: m: tools.m from: tools.from to: tools.to tz: tools.tz f: tools.f hideEventFilters: tools.hideEventFilters fn: tools.fn i: tools.i org: tools.org outputParameters: - type: object mapping: $. - name: get-metrics-based-visits-matching description: Get the Metrics Based on the Visits Matching the Specified Criteria hints: readOnly: true destructive: false idempotent: true call: usage-analytics-read-statistics-api-version-15.getv15statsvisitsmetrics with: m: tools.m from: tools.from to: tools.to tz: tools.tz f: tools.f hideEventFilters: tools.hideEventFilters fn: tools.fn org: tools.org outputParameters: - type: object mapping: $.