Coveo Cloud V2 API Overview

The Coveo Cloud platform is a native cloud SaaS/PaaS solution that provides a unified and secure way to query content across many enterprise systems. The platform relies on usage analytics data to yield Coveo Machine Learning (Coveo ML)-powered recommendations. The Coveo Cloud platform embraces the concepts of micro-services and scalability, allowing users to expand their search solution as their business grows.

As such, the Coveo Cloud platform exposes REST APIs which you can use to achieve anything you could do from the Coveo Cloud Administration Console or from a Coveo JavaScript Search Framework search interface.

The Search, Usage Analytics Write, and Usage Analytics Read APIs work with both Coveo Cloud V1 and V2 organizations. However, aside from those three services, the Coveo Cloud V1 platform does not publicly expose any API endpoints.

The following diagram provides a visual overview of the main interactions between the REST API services and a Coveo Cloud organization.

You may want to use the Official Coveo Cloud APIs JavaScript Client to query Coveo Cloud APIs.

Coveo Cloud V2 REST APIs

API name Usage Reference documentation Guide
Activity Access the activity information of a Coveo Cloud organization.
Authorization Server
  • Manage SAML security identity providers for a Coveo Cloud organization.
  • Manage groups, members, and API keys in a Coveo Cloud organization.
Catalog Manage catalogs in a Coveo Cloud organization. N/A
Extension Manage and test pre and post conversion indexing pipeline extensions.
Field Manage fields in an index.
Index Access the permission models of indexed items.
Machine Learning Manage Coveo ML models in an organization.
Notification Manage and test activity notification subscriptions for a Coveo Cloud organization.
Platform
  • Create, update, or delete a Coveo Cloud organization.
  • Access a Coveo Cloud organization status, login activity, license, and limit information.
  • Access Crawling module, worker, and database versions.
Push Push items and their respective permission models to a Push source, and push security identities to a security identity provider (as opposed to pulling content into a "standard" source using Coveo Cloud crawlers).
Schema Manage Coveo for Salesforce schemas. N/A
Search
Search Pages Manage hosted search pages in a Coveo Cloud organization. N/A
Search Usage Metrics Review search consumption data. N/A
Security Cache
  • Manage non-SAML security identity providers for a Coveo Cloud organization.
  • Manage security cache refresh schedules.
Source Manage sources and their related field mappings and pre- and post- conversion Coveo Cloud indexing pipeline extensions.
Source Logs Access the Coveo Cloud indexing pipeline logs of a source.
Usage Analytics Read Access usage analytics data (statistics, reports, dimensions, metrics, etc.).
Usage Analytics Write Record Coveo Usage Analytics (Coveo UA) events (click, search, view, or custom events).

Generated Swagger UI Documentation Site

You can visualize the API reference documentation and test API calls using the generated Swagger UI Coveo Cloud API reference documentation site (see Coveo Cloud Platform API).