naftiko: 1.0.0-alpha2 info: label: Coveo Usage Analytics Read API — Exports API - Version 15 description: 'Coveo Usage Analytics Read API — Exports API - Version 15. 19 operations. Lead operation: Lists All Exports. Self-contained Naftiko capability covering one Coveo business surface.' tags: - Coveo - Usage Analytics Read - Exports 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-exports-api-version-15 baseUri: https://analytics.cloud.coveo.com/rest/ua description: Coveo Usage Analytics Read API — Exports API - Version 15 business capability. Self-contained, no shared references. authentication: type: bearer token: '{{env.COVEO_API_KEY}}' resources: - name: v15-exports path: /v15/exports operations: - name: getv15exports method: GET description: Lists All Exports 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: postv15exports method: POST description: Generate an Export 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: 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: f in: query type: array description: The filter that will be applied to the events common dimensions (shared by all types of events). Multiple filter parameters are joined with the AND operator. - name: fs in: query type: array description: The filter that will be applied to the click and search events dimensions. Multiple filter parameters are joined with the AND operator. - name: fc in: query type: array description: The filter that will be applied to the custom events dimensions. Multiple filter parameters are joined with the AND operator. - name: filename in: query type: string description: A file name for the export. Can only contain US-ASCII characters. If none is supplied it will be set to the export's id. - name: d in: query type: string description: Export's description. - name: dimensions in: query type: array description: The dimensions that will be exported. If not provided, all dimensions will be exported. - name: tables in: query type: array description: The tables that will be exported. If not provided, all tables will be exported. - name: format in: query type: string description: The format of the generated CSV files. - name: useDisplayNames in: query type: boolean description: Whether to use the display names in the export's header. If false, the api names will be used. - name: v15-exports-create path: /v15/exports/create operations: - name: postv15exportscreate method: POST description: Generate an Export (with Parameters as Request Body) 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: body in: body type: object description: Request body (JSON). required: true - name: v15-exports-estimate path: /v15/exports/estimate operations: - name: getv15exportsestimate method: GET description: Estimate the Number of Rows in an Export 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: 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: tables in: query type: array description: The tables that will be exported. If not provided, all tables will be exported. - name: f in: query type: array description: The filter that will be applied to the events common dimensions (shared by all types of events). Multiple filter parameters are joined with the AND operator. - name: fs in: query type: array description: The filter that will be applied to the click and search events dimensions. Multiple filter parameters are joined with the AND operator. - name: fc in: query type: array description: The filter that will be applied to the custom events dimensions. Multiple filter parameters are joined with the AND operator. - name: v15-exports-monitoring-health path: /v15/exports/monitoring/health operations: - name: getv15exportsmonitoringhealth method: GET description: Health Check for the Exports Service outputRawFormat: json outputParameters: - name: result type: object value: $. - name: v15-exports-rowLimit path: /v15/exports/rowLimit operations: - name: getv15exportsrowlimit method: GET description: Get the Maximum Allowed Number of Rows an Export Can Have 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-exports-schedules path: /v15/exports/schedules operations: - name: getv15exportsschedules method: GET description: Get All the Export Schedules 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: postv15exportsschedules method: POST description: Create an Export Schedule 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: body in: body type: object description: Request body (JSON). required: true - name: v15-exports-schedules-exportScheduleId path: /v15/exports/schedules/{exportScheduleId} operations: - name: getv15exportsschedulesexportscheduleid method: GET description: Get Information on an Export Schedule 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: exportScheduleId in: path type: string description: The export schedule's unique identifier. required: true - name: putv15exportsschedulesexportscheduleid method: PUT description: Update an Existing Export Schedule 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: exportScheduleId in: path type: string description: The export schedule's unique identifier. required: true - name: body in: body type: object description: Request body (JSON). required: true - name: deletev15exportsschedulesexportscheduleid method: DELETE description: Delete an Export Schedule 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: exportScheduleId in: path type: string description: The export schedule's unique identifier. required: true - name: v15-exports-schedules-exportScheduleId-exports path: /v15/exports/schedules/{exportScheduleId}/exports operations: - name: getv15exportsschedulesexportscheduleidexports method: GET description: Get Exports Generated by the Specified Schedule 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: exportScheduleId in: path type: string description: The export schedule's unique identifier. required: true - name: v15-exports-status path: /v15/exports/status operations: - name: getv15exportsstatus method: GET description: Get the Exports Service Status outputRawFormat: json outputParameters: - name: result type: object value: $. - name: v15-exports-visits path: /v15/exports/visits operations: - name: postv15exportsvisits method: POST description: Generate a Visit Export 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: 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: 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: filename in: query type: string description: A file name for the export. Can only contain US-ASCII characters. If none is supplied it will be set to the export's id. - name: d in: query type: string description: Export's description. - name: dimensions in: query type: array description: The dimensions that will be exported. If not provided, all dimensions will be exported. - name: format in: query type: string description: The format of the generated CSV files. - name: ordered in: query type: boolean description: Whether to order the rows by datetime in the export. If the number of rows exported is to great, this parameter will be ignored and data will be unsorted. - name: useDisplayNames in: query type: boolean description: Whether to use the display names in the export's header. If false, the api names will be used. - name: v15-exports-visits-create path: /v15/exports/visits/create operations: - name: postv15exportsvisitscreate method: POST description: Generate a Visit Export (with Parameters as Request Body) 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: body in: body type: object description: Request body (JSON). required: true - name: v15-exports-visits-estimate path: /v15/exports/visits/estimate operations: - name: getv15exportsvisitsestimate method: GET description: Estimate the Number of Rows in a Visit Export 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: 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: 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: v15-exports-exportId path: /v15/exports/{exportId} operations: - name: getv15exportsexportid method: GET description: Get Information on an Export 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: exportId in: path type: string description: The export's unique identifier. required: true - name: redirect in: query type: boolean description: Whether to return a HTTP redirect to the actual file. - name: deletev15exportsexportid method: DELETE description: Delete an Export 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: exportId in: path type: string description: The export's unique identifier. required: true - name: v15-exports-exportId-downloadlink path: /v15/exports/{exportId}/downloadlink operations: - name: getv15exportsexportiddownloadlink method: GET description: Get the Download Link of an Export 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: exportId in: path type: string description: The export's unique identifier. required: true exposes: - type: rest namespace: usage-analytics-read-exports-api-version-15-rest port: 8080 description: REST adapter for Coveo Usage Analytics Read API — Exports API - Version 15. One Spectral-compliant resource per consumed operation, prefixed with /v1. resources: - path: /v1/v15/exports name: v15-exports description: REST surface for v15-exports. operations: - method: GET name: getv15exports description: Lists All Exports call: usage-analytics-read-exports-api-version-15.getv15exports with: org: rest.org outputParameters: - type: object mapping: $. - method: POST name: postv15exports description: Generate an Export call: usage-analytics-read-exports-api-version-15.postv15exports with: org: rest.org from: rest.from to: rest.to f: rest.f fs: rest.fs fc: rest.fc filename: rest.filename d: rest.d dimensions: rest.dimensions tables: rest.tables format: rest.format useDisplayNames: rest.useDisplayNames outputParameters: - type: object mapping: $. - path: /v1/v15/exports/create name: v15-exports-create description: REST surface for v15-exports-create. operations: - method: POST name: postv15exportscreate description: Generate an Export (with Parameters as Request Body) call: usage-analytics-read-exports-api-version-15.postv15exportscreate with: org: rest.org body: rest.body outputParameters: - type: object mapping: $. - path: /v1/v15/exports/estimate name: v15-exports-estimate description: REST surface for v15-exports-estimate. operations: - method: GET name: getv15exportsestimate description: Estimate the Number of Rows in an Export call: usage-analytics-read-exports-api-version-15.getv15exportsestimate with: org: rest.org from: rest.from to: rest.to tables: rest.tables f: rest.f fs: rest.fs fc: rest.fc outputParameters: - type: object mapping: $. - path: /v1/v15/exports/monitoring/health name: v15-exports-monitoring-health description: REST surface for v15-exports-monitoring-health. operations: - method: GET name: getv15exportsmonitoringhealth description: Health Check for the Exports Service call: usage-analytics-read-exports-api-version-15.getv15exportsmonitoringhealth outputParameters: - type: object mapping: $. - path: /v1/v15/exports/rowlimit name: v15-exports-rowlimit description: REST surface for v15-exports-rowLimit. operations: - method: GET name: getv15exportsrowlimit description: Get the Maximum Allowed Number of Rows an Export Can Have call: usage-analytics-read-exports-api-version-15.getv15exportsrowlimit with: org: rest.org outputParameters: - type: object mapping: $. - path: /v1/v15/exports/schedules name: v15-exports-schedules description: REST surface for v15-exports-schedules. operations: - method: GET name: getv15exportsschedules description: Get All the Export Schedules call: usage-analytics-read-exports-api-version-15.getv15exportsschedules with: org: rest.org outputParameters: - type: object mapping: $. - method: POST name: postv15exportsschedules description: Create an Export Schedule call: usage-analytics-read-exports-api-version-15.postv15exportsschedules with: org: rest.org body: rest.body outputParameters: - type: object mapping: $. - path: /v1/v15/exports/schedules/{exportscheduleid} name: v15-exports-schedules-exportscheduleid description: REST surface for v15-exports-schedules-exportScheduleId. operations: - method: GET name: getv15exportsschedulesexportscheduleid description: Get Information on an Export Schedule call: usage-analytics-read-exports-api-version-15.getv15exportsschedulesexportscheduleid with: org: rest.org exportScheduleId: rest.exportScheduleId outputParameters: - type: object mapping: $. - method: PUT name: putv15exportsschedulesexportscheduleid description: Update an Existing Export Schedule call: usage-analytics-read-exports-api-version-15.putv15exportsschedulesexportscheduleid with: org: rest.org exportScheduleId: rest.exportScheduleId body: rest.body outputParameters: - type: object mapping: $. - method: DELETE name: deletev15exportsschedulesexportscheduleid description: Delete an Export Schedule call: usage-analytics-read-exports-api-version-15.deletev15exportsschedulesexportscheduleid with: org: rest.org exportScheduleId: rest.exportScheduleId outputParameters: - type: object mapping: $. - path: /v1/v15/exports/schedules/{exportscheduleid}/exports name: v15-exports-schedules-exportscheduleid-exports description: REST surface for v15-exports-schedules-exportScheduleId-exports. operations: - method: GET name: getv15exportsschedulesexportscheduleidexports description: Get Exports Generated by the Specified Schedule call: usage-analytics-read-exports-api-version-15.getv15exportsschedulesexportscheduleidexports with: org: rest.org exportScheduleId: rest.exportScheduleId outputParameters: - type: object mapping: $. - path: /v1/v15/exports/status name: v15-exports-status description: REST surface for v15-exports-status. operations: - method: GET name: getv15exportsstatus description: Get the Exports Service Status call: usage-analytics-read-exports-api-version-15.getv15exportsstatus outputParameters: - type: object mapping: $. - path: /v1/v15/exports/visits name: v15-exports-visits description: REST surface for v15-exports-visits. operations: - method: POST name: postv15exportsvisits description: Generate a Visit Export call: usage-analytics-read-exports-api-version-15.postv15exportsvisits with: org: rest.org from: rest.from to: rest.to f: rest.f hideEventFilters: rest.hideEventFilters fn: rest.fn filename: rest.filename d: rest.d dimensions: rest.dimensions format: rest.format ordered: rest.ordered useDisplayNames: rest.useDisplayNames outputParameters: - type: object mapping: $. - path: /v1/v15/exports/visits/create name: v15-exports-visits-create description: REST surface for v15-exports-visits-create. operations: - method: POST name: postv15exportsvisitscreate description: Generate a Visit Export (with Parameters as Request Body) call: usage-analytics-read-exports-api-version-15.postv15exportsvisitscreate with: org: rest.org body: rest.body outputParameters: - type: object mapping: $. - path: /v1/v15/exports/visits/estimate name: v15-exports-visits-estimate description: REST surface for v15-exports-visits-estimate. operations: - method: GET name: getv15exportsvisitsestimate description: Estimate the Number of Rows in a Visit Export call: usage-analytics-read-exports-api-version-15.getv15exportsvisitsestimate with: org: rest.org from: rest.from to: rest.to f: rest.f hideEventFilters: rest.hideEventFilters fn: rest.fn outputParameters: - type: object mapping: $. - path: /v1/v15/exports/{exportid} name: v15-exports-exportid description: REST surface for v15-exports-exportId. operations: - method: GET name: getv15exportsexportid description: Get Information on an Export call: usage-analytics-read-exports-api-version-15.getv15exportsexportid with: org: rest.org exportId: rest.exportId redirect: rest.redirect outputParameters: - type: object mapping: $. - method: DELETE name: deletev15exportsexportid description: Delete an Export call: usage-analytics-read-exports-api-version-15.deletev15exportsexportid with: org: rest.org exportId: rest.exportId outputParameters: - type: object mapping: $. - path: /v1/v15/exports/{exportid}/downloadlink name: v15-exports-exportid-downloadlink description: REST surface for v15-exports-exportId-downloadlink. operations: - method: GET name: getv15exportsexportiddownloadlink description: Get the Download Link of an Export call: usage-analytics-read-exports-api-version-15.getv15exportsexportiddownloadlink with: org: rest.org exportId: rest.exportId outputParameters: - type: object mapping: $. - type: mcp namespace: usage-analytics-read-exports-api-version-15-mcp port: 9090 transport: http description: MCP adapter for Coveo Usage Analytics Read API — Exports API - Version 15. One tool per consumed operation, routed inline through this capability's consumes block. tools: - name: lists-all-exports description: Lists All Exports hints: readOnly: true destructive: false idempotent: true call: usage-analytics-read-exports-api-version-15.getv15exports with: org: tools.org outputParameters: - type: object mapping: $. - name: generate-export description: Generate an Export hints: readOnly: false destructive: false idempotent: false call: usage-analytics-read-exports-api-version-15.postv15exports with: org: tools.org from: tools.from to: tools.to f: tools.f fs: tools.fs fc: tools.fc filename: tools.filename d: tools.d dimensions: tools.dimensions tables: tools.tables format: tools.format useDisplayNames: tools.useDisplayNames outputParameters: - type: object mapping: $. - name: generate-export-parameters-request-body description: Generate an Export (with Parameters as Request Body) hints: readOnly: false destructive: false idempotent: false call: usage-analytics-read-exports-api-version-15.postv15exportscreate with: org: tools.org body: tools.body outputParameters: - type: object mapping: $. - name: estimate-number-rows-export description: Estimate the Number of Rows in an Export hints: readOnly: true destructive: false idempotent: true call: usage-analytics-read-exports-api-version-15.getv15exportsestimate with: org: tools.org from: tools.from to: tools.to tables: tools.tables f: tools.f fs: tools.fs fc: tools.fc outputParameters: - type: object mapping: $. - name: health-check-exports-service description: Health Check for the Exports Service hints: readOnly: true destructive: false idempotent: true call: usage-analytics-read-exports-api-version-15.getv15exportsmonitoringhealth outputParameters: - type: object mapping: $. - name: get-maximum-allowed-number-rows description: Get the Maximum Allowed Number of Rows an Export Can Have hints: readOnly: true destructive: false idempotent: true call: usage-analytics-read-exports-api-version-15.getv15exportsrowlimit with: org: tools.org outputParameters: - type: object mapping: $. - name: get-all-export-schedules description: Get All the Export Schedules hints: readOnly: true destructive: false idempotent: true call: usage-analytics-read-exports-api-version-15.getv15exportsschedules with: org: tools.org outputParameters: - type: object mapping: $. - name: create-export-schedule description: Create an Export Schedule hints: readOnly: false destructive: false idempotent: false call: usage-analytics-read-exports-api-version-15.postv15exportsschedules with: org: tools.org body: tools.body outputParameters: - type: object mapping: $. - name: get-information-export-schedule description: Get Information on an Export Schedule hints: readOnly: true destructive: false idempotent: true call: usage-analytics-read-exports-api-version-15.getv15exportsschedulesexportscheduleid with: org: tools.org exportScheduleId: tools.exportScheduleId outputParameters: - type: object mapping: $. - name: update-existing-export-schedule description: Update an Existing Export Schedule hints: readOnly: false destructive: false idempotent: true call: usage-analytics-read-exports-api-version-15.putv15exportsschedulesexportscheduleid with: org: tools.org exportScheduleId: tools.exportScheduleId body: tools.body outputParameters: - type: object mapping: $. - name: delete-export-schedule description: Delete an Export Schedule hints: readOnly: false destructive: true idempotent: true call: usage-analytics-read-exports-api-version-15.deletev15exportsschedulesexportscheduleid with: org: tools.org exportScheduleId: tools.exportScheduleId outputParameters: - type: object mapping: $. - name: get-exports-generated-specified-schedule description: Get Exports Generated by the Specified Schedule hints: readOnly: true destructive: false idempotent: true call: usage-analytics-read-exports-api-version-15.getv15exportsschedulesexportscheduleidexports with: org: tools.org exportScheduleId: tools.exportScheduleId outputParameters: - type: object mapping: $. - name: get-exports-service-status description: Get the Exports Service Status hints: readOnly: true destructive: false idempotent: true call: usage-analytics-read-exports-api-version-15.getv15exportsstatus outputParameters: - type: object mapping: $. - name: generate-visit-export description: Generate a Visit Export hints: readOnly: false destructive: false idempotent: false call: usage-analytics-read-exports-api-version-15.postv15exportsvisits with: org: tools.org from: tools.from to: tools.to f: tools.f hideEventFilters: tools.hideEventFilters fn: tools.fn filename: tools.filename d: tools.d dimensions: tools.dimensions format: tools.format ordered: tools.ordered useDisplayNames: tools.useDisplayNames outputParameters: - type: object mapping: $. - name: generate-visit-export-parameters-request description: Generate a Visit Export (with Parameters as Request Body) hints: readOnly: false destructive: false idempotent: false call: usage-analytics-read-exports-api-version-15.postv15exportsvisitscreate with: org: tools.org body: tools.body outputParameters: - type: object mapping: $. - name: estimate-number-rows-visit-export description: Estimate the Number of Rows in a Visit Export hints: readOnly: true destructive: false idempotent: true call: usage-analytics-read-exports-api-version-15.getv15exportsvisitsestimate with: org: tools.org from: tools.from to: tools.to f: tools.f hideEventFilters: tools.hideEventFilters fn: tools.fn outputParameters: - type: object mapping: $. - name: get-information-export description: Get Information on an Export hints: readOnly: true destructive: false idempotent: true call: usage-analytics-read-exports-api-version-15.getv15exportsexportid with: org: tools.org exportId: tools.exportId redirect: tools.redirect outputParameters: - type: object mapping: $. - name: delete-export description: Delete an Export hints: readOnly: false destructive: true idempotent: true call: usage-analytics-read-exports-api-version-15.deletev15exportsexportid with: org: tools.org exportId: tools.exportId outputParameters: - type: object mapping: $. - name: get-download-link-export description: Get the Download Link of an Export hints: readOnly: true destructive: false idempotent: true call: usage-analytics-read-exports-api-version-15.getv15exportsexportiddownloadlink with: org: tools.org exportId: tools.exportId outputParameters: - type: object mapping: $.