# Integrations Dashboard

The **Integrations Dashboard** provides a centralized view of all integrated applications, along with detailed information about fetches and syncs. From this interface, users can add or remove integrations, configure settings, establish data syncs, and manually refresh or sync data.

<figure><img src="/files/8YxkBaGIrcLbwJOi7wod" alt="" width="563"><figcaption></figcaption></figure>

<details>

<summary>Top Toolbar and Performance Metrics</summary>

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

The top toolbar displays performance metrics for Fetches and Syncs, along with several action buttons that support configuration, scheduling, and running processes on demand.

**Buttons**

* <img src="/files/IS4aq5Ad1Nr6RFUu4LLg" alt="" data-size="line"> - Create a new integration
* <mark style="background-color:purple;">REFRESH ALL</mark> - Refresh all data fetches
* <mark style="background-color:purple;">PAUSE ALL</mark> - Stop all integrations from executing future scheduled fetches and syncs&#x20;

{% hint style="info" %}
Note: To un-pause, resume each integration individually using the "Resume" button
{% endhint %}

**Performance Metrics**

* Displays the number of recent Successful Fetches, Failed Fetches, currently Running Fetches and Paused Fetches.

</details>

<details>

<summary>Integration Table</summary>

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

**Columns**

* **Name:** Name of Application and the data types Violet will fetch from the Application. The data types are listed below the application name.
* **Status**: Status of ongoing or most recent fetch.
* **Syncs To**: If the integration is sending data to other applications, they will be listed here.
* **Created**: Name of user who created the integration and the date and time it was created.

**Actions**: Allow you to edit the integration configuration.

* <img src="/files/LftwQBgqInoVydmzYHao" alt="" data-size="line">  - **Subscribe To:** Subscribe to receive updates about fetch events for the selected integration in a daily email.&#x20;
* <img src="/files/9xaaJ7makuCsppTYwpny" alt="" data-size="line"> - **Configure Sync Event Subscriptions:** Subscribe to receive information about sync events for the selected integration in a daily email.&#x20;
  * From the following window, you can choose what type of events will be included in the subscription email -> **Errors**,  **Health** **Information**, or **Warnings**.

<figure><img src="/files/vK6PyRy26bZ70iOoQHhV" alt="" width="375"><figcaption></figcaption></figure>

* <img src="/files/VQLPyeP5IWvAzPWptPSh" alt="" data-size="line"> - **Fetch Updates:** Run a fetch. Click button again mid-fetch to cancel/stop the fetch process.
* <img src="/files/KVLTRJBRejH2Iua9BBVW" alt="" data-size="line"> - **Pause:** Pauses scheduled fetches.
* <img src="/files/ZpoKGjJLTBscDQ7yTM1m" alt="" data-size="line"> - **Resume:** Resumes scheduled fetches.
* <img src="/files/ua4YbePpqXWga7PQl9mD" alt="" data-size="line"> - **Edit**: Opens the *Configure App* menu, which allows you to reconfigure the integration. From this menu, you can change the application, adjust data types, and define how often to run or refresh Fetches.&#x20;
* ![](/files/l95Dq9fgYRzojiwdJjZs) - **View Change History:** Review who made what changes to the integration configuration, when.

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

{% hint style="info" %}
More than one integration can be created for a given application in order to fetch different data types on different frequencies, support different permission schemes for different data types etc.
{% endhint %}

</details>

<details>

<summary>Integration Metrics</summary>

Click on an integration row to view its performance metrics, including the fetch and sync duration over time.

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

**Buttons**

* <mark style="background-color:purple;">**Refresh Data:**</mark> Click this button (located under the Fetch Time graph) to run a **Full Fetch** of all data from the integration. Unlike the “Run a Fetch” button which only looks for changes since the last fetch, the Refresh Data button will review all data for the requested data type(s).
* If integration is set to **Push Data** there is also an on-demand push button below the graph.
* <img src="/files/3FekeE68FE4xKMRiKb1t" alt="" data-size="line"> **Integration Timeline:** In the top right corner of the Integration Health Metrics view allows to view the details for each Fetch or Pull.

<figure><img src="/files/7PHoQzBSnvtbLH1OBJEP" alt="" width="258"><figcaption></figcaption></figure>

{% hint style="info" %}
To see failures in data *syncs*, navigate to the timeline of the *source integration* for that data sync (ie. where the data originates). To see more details about the failure, expand the status to show the error message. Click on **Entity Link** to navigate to the specific entity that failed.
{% endhint %}

<figure><img src="/files/lvY54injBjfKE4JPmZVk" alt="" width="375"><figcaption></figcaption></figure>

</details>


---

# 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.violetlabs.com/integrations/integrations-dashboard.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.
