- Manage Sources
- Review Indexing Logs
- Manage Fields
- Browse Your Content
- Use Indexing Pipeline Extensions
- Troubleshoot Content Access Issues
- Use the Crawling Module
Use the Push API
- Usage Example
- Leading Practices
- Manage Items and Permissions
- Manage Security Identities in a Security Identity Provider
- Update the Status of a Push Source
- Reset a Push Source
- Create a File Container
- orderingId Parameter
- API Processing Delay
- Troubleshoot API Error Codes
- API Reference
The articles in this section explain how to use the Push API.
The Push API exposes services which allow you to push items and their permission models into a source, and security identities into a security identity provider, rather than letting standard Coveo crawlers pull this content.
There’s no graphical user interface sitting on top of the Push API, so you need to perform your own HTTP calls when you want to use its services.
You may want to consider using the open source Coveo Push API SDK for Python to interact with the Push API.
The following diagram provides a visual overview of the main interactions between custom crawlers, the Push API and a Coveo organization.
Push API Usage Overview
In general, using the Push API requires the following set up:
If your Push source is secured, create a security identity provider.
In contrast with creating a standard source, creating a Push source never generates fields in your index as a side effect.
In contrast with a standard source, a new Push source doesn’t include default mappings. However you should be aware that Push sources have a peculiar default behavior when it comes to populating fields with metadata values (see About Push Source Item Metadata).
After this set up, you would use the Push API. In general this consists of writing code to regularly:
Add, update, or delete content as appropriate in your Push source and security identity provider using the Push API. See:
If you have never used the Push API before, a good way to get started is to go through the Push API Usage Example.
Interactive generated reference documentation is also available through Swagger UI (see Coveo Platform API - Push API).