# Handling failed service syncs
## Introduction
The Patchworks [sync report](/product-documentation/patchworks-services/reporting-and-logging/service-sync-reports/viewing-the-service-sync-report.md) includes options to manage cases where a sync fails. This page includes instructions for handling a single failure, and also for handling multiple failures in one, 'mass' action.
{% hint style="info" %}
If retrying a sync does not resolve the issue, try the [run service tab](/product-documentation/patchworks-services/troubleshooting/how-to-run-a-service-manually.md) for additional sync options - including options to download payloads for further checking.
{% endhint %}
## Initial checks
If a sync fails, it's always worth checking the operational status of its **source** and **destination** connectors. Please see [how to check the operational status of a connector](/product-documentation/patchworks-services/troubleshooting/how-to-check-the-operational-status-of-a-service-connector.md) for details.
## Handling a failed sync for a single entry
If a single sync report entry has a [failed status](/product-documentation/patchworks-services/reporting-and-logging/service-sync-reports/viewing-the-service-sync-report.md#sync-report-status-indicators) and you've [confirmed that source/destination connectors for the service are operational](/product-documentation/patchworks-services/troubleshooting/how-to-check-the-operational-status-of-a-service-connector.md), you can retry the sync. To do this for a single entry, follow the steps below:
**Step 1**\
Click the **error details** link associated with the entry that you wish to resync - for example:
{% hint style="info" %}
To quickly find all failed sync entries, use filter options to refine the sync report and choose to only show items with a **failed** status:
{% endhint %}
**Step 2**\
When details for the failed entry are displayed, check the **failure reason/error** information. If appropriate, take necessary action - this might mean checking and adjusting your source/destination system, or checking and adjusting the Patchworks [field mappings](/product-documentation/patchworks-services/working-with-services/field-mappings-and-transformations-services/field-mappings-services.md) for this service. For example:
**Step 3**\
When you're ready, click the **resync** button from the same details window.
{% hint style="info" %}
A **resync** button is only displayed if the failure reason allows. For example, if a sync fails because the item has already been processed, a **resync** button is not available.
{% endhint %}
**Step 4**\
When prompted to confirm this operation, click **OK**. If the resync is successful, the status will change to **OK**.
{% hint style="info" %}
Any update may not be immediate as the resync needs to take its place in the processing queue.
{% endhint %}
{% hint style="info" %}
Alternatively, you can follow the steps detailed [below](#handling-a-failed-sync-for-multiple-entries) but only select one entry to be resynced.
{% endhint %}
## Handling a failed sync for multiple entries
If a sync report includes multiple entries with a [failed status](https://doc.wearepatchworks.com/dashboard/reporting-and-logging/sync-reports/viewing-the-sync-report#sync-report-status-indicators) and you've [confirmed that source/destination connectors for the service are operational](/product-documentation/patchworks-services/troubleshooting/how-to-check-the-operational-status-of-a-service-connector.md), you can retry the sync for them all as a **mass action**. To do this, follow the steps below:
**Step 1**\
Use filter options to refine the sync report and choose to only show items with a **failed** status:
...so only failed items are shown.
**Step 2**\
For each item in turn, click the associated **error details** link - for example:
**Step 3**\
When details for the failed entry are displayed, check the **failure reason /error** information. If appropriate, take necessary action - this might mean checking and adjusting your source/destination system, or checking and adjusting the Patchworks [field mappings](/product-documentation/patchworks-services/working-with-services/field-mappings-and-transformations-services/field-mappings-services.md) for this service. For example:
**Step 4**\
When you're ready, click the selection checkbox associated with any failed entries that you wish to resync, and then select **auto** **resync** from the ellipses menu - for example:
{% hint style="info" %}
To quickly select all failed entries that are currently displayed, click the selection checkbox at the very top of the list (to the left of the **status** heading).
{% endhint %}
**Step 5**\
When prompted to confirm this operation, click **OK**. If the resync is successful, the status will change to **OK**.
{% hint style="info" %}
Any update may not be immediate as the resync needs to take its place in the processing queue.
{% endhint %}
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://doc.wearepatchworks.com/product-documentation/patchworks-services/reporting-and-logging/service-sync-reports/handling-failed-service-syncs.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.