Articles in this section

Retry or resolve flow errors

Once you've reviewed an error's details on the Errors page, you can retry it after correcting the data, or resolve it to dismiss it without a retry. This article covers reviewing errors before you act on them, retrying or resolving a single error, several errors at once, a full batch or bulk operation, canceling a retry in progress, and downloading errors for offline review. For an explanation of the page layout, tabs, and columns referenced below, see Understand the Errors page.

Prerequisites:

  • Permissions — You need Administer or Manage permissions to modify connection settings, retry errors, or resolve records. Monitor users can typically only view error details, though an admin can grant them permission to edit retry data.
  • Data retention — Retry data is available for the most recent 20,000 errors per flow step, or according to your data retention plan.
  • Time limits — You can retry an open error if its record timestamp falls within the last 30 days by default, or up to 180 days depending on your subscription.

Review an error before acting

Use the classification and source shown in an error's details to decide what kind of fix it needs before you edit retry data. You can also ask Celigo Ora to analyze an error, or to stage a retry data fix across every matching error in the step — see Error management with Celigo Ora.

By classification — see Error classifications for the full reference. Common actions:

Classification What you can do
Connection Re-enter credentials, or check access permissions for the account.
Duplicate Correct the mapping in your flow step to prevent duplicate records.
Rate limit Adjust concurrency values, or wait for the rate limit to reset.
Too large Decrease the page size, enable chunking or pagination, or pre-filter your data.
Missing Enter the required missing details in the source record.
Parse Correct the mapping logic or Handlebars expression in the flow step.
Value Check whether your data matches what the endpoint expects.

By source — the source points to the specific stage or component where the failure occurred:

Source Where to look
Export The export preview, for issues in the data extracted from the source application.
Import The import preview, for issues in the data being sent to the destination application.
Lookup or data retrieval Failures during lookups, or issues in reference data.
Transformation or mapping Field mappings, transformations, or data-shaping logic.
Script or hook Custom JavaScript (pre-map, post-map, pre-save, and so on).
Connection or endpoint Authentication, connectivity, or API issues from the external system — check the endpoint's own documentation for API-specific errors.

The timestamp also matters: if an error started appearing in a flow that had been running cleanly, check the audit log for a change around that time. See View or download your audit logs.

Retry or resolve a single error

  1. Go to the account or integration Dashboard and select the error count for the flow step you want to work on.
  2. On the Open errors tab, select the checkbox next to the error. The row highlights.
  3. Review the error and payload details. If needed, edit the retry data in the error details or error list section before retrying.
  4. In the error details panel, select Retry to fix the error, or select Resolve to dismiss it without retrying.

Retry data you save persists across sessions, even if you don't retry immediately. An edited-but-not-yet-retried error shows a blue dot next to its checkbox.

You can track the retry's progress at the top of the page, or select the Retries tab for details on the run.

Retry or resolve several errors

  1. Go to the account or integration Dashboard and select the error count for the flow step you want to work on.
  2. On the Open errors tab, use filters to narrow the list, then select the checkboxes for the errors you want, or select Select all to select every error on the current page (up to 1,000 records). Select all selects every row on the page regardless of any active filter or search.
  3. Review the errors and, if needed, edit retry data for any of them.
  4. Select Retry to fix the selected errors, or Resolve to dismiss them.

Batch and bulk retry or resolve

Use a batch operation to act on everything on the current page (up to 1,000 errors), or a bulk operation to act on the entire list across pages (up to 20,000 errors). Both ignore any active filter or search — selecting all errors this way selects every error that matches, including ones on pages you aren't currently viewing.

  1. Go to the account or integration Dashboard and select the error count for the flow step you want to work on.
  2. On the Open errors tab, select the Select all checkbox.
  3. Choose one:
    • Batch (current page only): select Retry to retry every error on the page, or Resolve to dismiss them.
    • Bulk (entire list across pages): select Manage all, then Retry all to retry every error in the list, or Resolve all to dismiss them.

The number of errors about to be affected shows in the Manage all menu items, such as Retry all (N), and again at the top of the page under Results.

Cancel a retry in progress

  1. Select the Retries tab.
  2. In the Actions elipses-button.png column for the retry you want to stop, select Cancel retry.
  3. Read the confirmation message, then select Cancel retry again to confirm.

Canceling a retry stops any errors not yet processed; errors already processed keep their current state (either resolved or still failed) — canceling doesn't revert them.

Download errors for offline review

  1. Go to the account or integration Dashboard and select the error count for the flow step you want to work on.
  2. On the Open errors tab, select the Download errors icon at the top right of the list.
  3. On the Download errors page, either select specific From and To dates, or select Download all.
  4. If you chose a specific date range, select Download.

The downloaded file saves to your browser's default download location.