---
title: "Error handling | Lansweeper Platform"
slug: "error-handling"
description: "Learn how to handle API errors with workflow-level and step-level error handling to ensure smooth data processing and minimize disruptions."
updated: 2026-06-12T14:31:20Z
published: 2026-06-12T14:31:20Z
canonical: "docs.lansweeper.com/error-handling"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lansweeper.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Error Handling

Errors happen. An API you pull data from may encounter a temporary outage, or the "eventually" part of an "eventually consistent" database may need a couple more seconds to save a record. When you encounter errors, you have two tools to handle them:

1. Workflow-level error handling
2. Step-level error handling

## Workflow-level error handling

If an execution fails, you can have the runner automatically retry a few minutes later. The webhook payload you received will be passed back through your Workflow again, and your Workflow will start again at its first step. This is useful if your Workflow is [idempotent](https://en.wikipedia.org/wiki/Idempotence) and you don't know which step might fail.

To configure automatic retry, select the gear icon (Workflow Details button) on the left side of the canvas, and then select **Configure Workflow retry**. You can configure your Workflow to retry a certain number of times, waiting a specified number of minutes between retries.

![Workflow-level error handling](https://cdn.document360.io/21d5935c-1b73-44fa-bf5a-a8b0f5c67f25/Images/Documentation/flow-level-error-handling.png)

## Step-level error handling

You might not want your entire Workflow to stop because one step failed, especially if you're looping over hundreds of items and one item has issues.

You can configure how the runner should handle errors on each step. To do that, click a step that you would like to configure, and then open the **Error Handling** tab in the step configuration drawer.

![Step-level error handling](https://cdn.document360.io/21d5935c-1b73-44fa-bf5a-a8b0f5c67f25/Images/Documentation/step-level-error-handling.png)

Under **Error Handler Type** you have three options:

- **Fail** - stop the Workflow and throw an error.
- **Ignore** - ignore the error and continue running the remaining steps.
- **Retry** - wait for an amount of time (**Seconds between attempts**) and then try the step again, a maximum of **Retry attempts** times.  

If the last attempt still fails, either fail the Workflow or ignore the error depending on whether **Ignore Final Error** is true or false.