Skip to main content
Tasks represent the discrete units of work an integration performs, such as a single configured query in a database extractor. CDF tracks each task’s run history, including when it started and stopped. You can list task history or sync updates since a previous checkpoint. A task is a named unit of work in an integration, reported by the extractor. Each time a task starts or stops, the extractor reports it in a check-in request, and CDF records a history entry so you can spot gaps or failures.

​
Listing and syncing history

You can list task history for an integration, optionally filtered by task name, to see when tasks ran. For applications that need to keep up with changes incrementally, sync returns task history and error updates since the last sync. Use a cursor to avoid re-reading data you have already seen.
Use sync rather than repeatedly listing history when you are building a live dashboard or alerting system. Sync is designed for incremental polling.

​
Key operations

  • List history: Retrieve task run history for an integration, optionally filtered by task name.
  • Sync: Fetch task and error updates since a previous cursor.
Task history is the record CDF uses to answer “Is this extractor doing what it’s supposed to do?”
Last modified on September 25, 2026