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
Updating the Status of a Push Source
The status of a source should change as soon as a process begins retrieving content to be added, updated, and/or deleted in that source, and it should change again as soon as this process ends. The status changes of a source make up its basic activity logs, which can be seen from the Sources page in the Coveo Administration Console.
Standard connectors automatically update the status of their respective sources, but it’s your responsibility to update the status of your custom Push sources. Otherwise, those sources will always appear as Ready to receive content in the Coveo Administration Console.
When you start or finish performing a set of operations to update a Push source, you should update its status accordingly.
Set the Push source to one of the active statuses (
INCREMENTAL) prior to retrieving new or updated content to be indexed in the source:
Status name Corresponding status name in the Coveo Administration Console When to set the Push source to this status Typical resource cost
Rebuild You plan to re-index the entire content of the source, updating all previously indexed items in the process. High
Rescan You plan to scan the current content of the source, compare it with the content you intend to push, and only update new, modified, and/or deleted items in the source. Moderate
Refresh You plan to use a feature of the indexed enterprise system to identify and push only the delta between the system in its present state and the current content of the source, without scanning the content of the source first. Low
Set the status of the Push source back to
IDLEwhen you’re done performing the Push API operations that forward the retrieved content update to your index.
POST https://api.cloud.coveo.com/push/v1/organizations/<MyOrganizationId>/sources/<MySourceId>/status?statusType=<MyStatusType> HTTP/1.1 Authorization: Bearer <MyAccessToken>
In the request path:
<MyOrganizationId>with the ID of the target Coveo organization (see Retrieve the Organization ID).
<MySourceId>with the ID of the target Push source.
In the request query string:
<MyStatusType>with the desired
Authorization HTTP header:
<MyAccessToken>with an access token that grants the Organization - View/Edit and Sources - View privileges in the target Coveo organization (see Add an API Key).
A successful response (
201 Created) has no content, but it signifies that the status of the target Push source has been updated.
Setting the status of a Push source to REFRESH
POST https://api.cloud.coveo.com/push/v1/organizations/mycoveocloudv2organizationg8tp8wu3/sources/mycoveocloudv2organizationg8tp8wu3-rp5rxzbdz753uhndklv2ztkfgy/status?statusType=REFRESH HTTP/1.1 Authorization: Bearer **********-****-****-****-************
201 Created response body