# Using Run Reports

Run Reports display all the actions that the TaskBot took during its run. These reports are essential for troubleshooting failed runs.

### Where to Find Run Reports

1. On the TaskBots list page

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

2. Inside the TaskBot builder page

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

***

### How Run Reports Are Displayed

Reports provide detailed information about the TaskBot's run, including timestamps, statuses, and actions taken. Here's an example of how they appear:

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

***

### Tip for Easier Troubleshooting

* Click **View Logs** to access the logs of the run.
* Use the **Side View** feature to position the logs next to your TaskBot workflow for easy comparison.
* Click **View Building Block** to zoom in on the block you're inspecting.

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

Here is an example:

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

***

### Notifications

You can set up notifications to be sent via **email**, **Slack**, or **custom** **webhook**. Your notifications will always include error reports.

**Notification Types**

* **Email**: Add recipient email addresses. Here's an example:

<figure><img src="/files/3tXZyPWBgJOX3K7jEjQe" alt=""><figcaption></figcaption></figure>

* **Slack**: Provide your Slack webhook URL. Learn how to get it [**here**](https://api.slack.com/messaging/webhooks). Here's an example:

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

* **Webhook**: Add a custom webhook URL to receive POST notifications. Here’s an example of the JSON structure sent via webhook:

```
{
  "agent_version": "1.1.69",
  "taskbot_id": 1,
  "taskbot_name": "Your TaskBot name",
  "taskbot_url": "https://creator.zerowork.io/workflows/1",
  "run_status": "success" | "fail" | "warning" | "unknown" | "manually_stopped",
  "run_type": "webhook" | "scheduled" | "immediate",
  "run_duration": "2.1 hours",
  "run_errors": [
    {
      "id": 1,
      "timestamp": "2024-10-06T13:01:43.755052-04:00",
      "error_message": "Some error message",
      "counter": 5,
      "screenshot": "<screenshot_url>",
      "building_block": {
        "id": "54254235",
        "name": "Your Custom Block Name",
        "type": "Update Data"
      }
    },
    {
      "id": 2,
      "timestamp": "2024-10-06T13:01:45.755052-04:00",
      "error_message": "Some other error message",
      "counter": 1,
      "screenshot": "",
      "building_block": {}
    },
  ]
}
```


---

# 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://docs.zerowork.io/using-zerowork/using-run-reports.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.