Skip to main content
The errors API gives you access to errors reported by an integration’s tasks. Errors are associated with the task and time range during which they occurred, so you can correlate failures with specific parts of an extractor’s work. You retrieve errors by listing them, optionally filtered by task or time range. An integration error is a problem an extractor encountered while running a task, reported to CDF in a check-in request. Each error is linked to the task it occurred in and includes a start time, plus an end time once the extractor reports it as resolved.

​
Listing and filtering errors

You can list all errors for an integration, or narrow the results to a specific task name or time window. This makes it possible to build alerting on new errors, or to investigate a specific incident by looking at what failed and when.
Combine error listing with task history to see the full picture: what was running, what failed, and when it recovered.

​
Key operations

  • List: Retrieve errors for an integration, filtered by task name or time range.
Errors are the primary signal for troubleshooting a misbehaving extractor, alongside task history and logs the extractor produces on its own.
Last modified on August 28, 2026