# Downloading run logs

## Introduction

If required, you can download run logs for a completed process flow run in CSV format, for use outside of Patchworks. 

## Need to know

Run log exports are completed in CSV format. The exported file includes two columns with `level` and `message`  headers. For example:

{% code lineNumbers="true" %}

```
level,message
info,"Flow initialised by Manual trigger."
info,"Flow step connector started"
info,"Connecting to Shopify"
error,"Connection to Shopify failed"
warning,"Errno: 60"
error,"Flow step connector failed: attempt (1/2)"
warning,"Error: 'SSL: no alternative certificate subject name matches target host name 'patchworks-docs-demo.myshopify.com.myshopify.com''"
info,"Flow step connector started"
info,"Connecting to Shopify"
error,"Connection to Shopify failed"
warning,"Errno: 60"
warning,"Error: 'SSL: no alternative certificate subject name matches target host name 'patchworks-docs-demo.myshopify.com.myshopify.com''"
error,"Flow step connector failed: attempt (2/2)"
error,"Flow run #01hsdkz31xzfe6jpvcpz7fgtf5 failed."
error,"Error: Internal error, please contact support if this issue persists."
```

{% endcode %}

## The steps

To download run logs for a specific process flow run, follow the steps below. 

**Step 1**\
Log into the Patchworks dashboard and [access your run logs & queue](/product-documentation/process-flows/error-reporting-and-exception-handling/run-logs-and-queue.md#accessing-your-run-logs-and-queue-page).

**Step 2**\
Click the ellipses icon to access additional options for the log entry, then select the **download logs** option - for example:

<div align="left"><figure><img src="/files/qS5rIcYw2eVc9e8alIzS" alt=""><figcaption></figcaption></figure></div>

**Step 3**\
The download job is added to a queue and a confirmation message is displayed:

<div align="left"><figure><img src="/files/D0HR86T8ANCV8BzhUHEx" alt=""><figcaption></figcaption></figure></div>

**Step 4**\
When your download is ready, you'll receive an email which includes a link to retrieve the file from the **file downloads** page. If you can't/don't want to use this link, you can access this page manually by selecting the **settings** option:

<div align="left"><figure><img src="/files/hvl7x5MerEwLLtIyTQaE" alt="" width="214"><figcaption></figcaption></figure></div>

...followed by the **file downloads** option:

<div align="left"><figure><img src="/files/bhsqLHeCwsHwUkXdJHBt" alt="" width="563"><figcaption></figcaption></figure></div>

**Step 5**\
On the **file downloads** page, you'll find any exports that have been completed for your company profile in the last hour. Click the **download** button for your job:                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        &#x20;

<figure><img src="/files/gQTYeykjHRwgpfKxp6Fg" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
This list may include exports from different parts of the dashboard, not just run logs (for example, [de-dupe](/product-documentation/process-flows/building-process-flows/process-flow-shapes/advanced-shapes/de-dupe-shape/importing-and-exporting-de-dupe-data.md) and [cross-reference lookup](/product-documentation/process-flows/cross-reference-lookups/importing-and-exporting-cross-reference-lookups.md) data exports are added here).
{% endhint %}

**Step 6**\
The associated CSV file is saved to the default downloads folder for your browser.

{% hint style="info" %}
Download files are cleared after one hour. If you are unable to download your file within this time, don't worry - simply download the logs again to create a new one.&#x20;
{% 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/process-flows/error-reporting-and-exception-handling/run-logs-and-queue/working-with-run-logs/downloading-run-logs.md?ask=<question>
```

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.