# Workflow Notifications

Stack AI can alert you when a workflow starts failing repeatedly, so you can catch broken workflows before they affect your users.

### How it works

Every time a workflow run fails, Stack AI tracks the number of consecutive failures. Once that count reaches a threshold, a notification is sent. The counter resets as soon as a run succeeds.

By default, you are notified after **3 consecutive failures**. The notification is sent via **email** and as an **in-app alert** (bell icon, top nav).

The email subject is `StackAI Flow Error Notification` and includes the workflow name and the number of consecutive failures. The in-app alert reads: *"Project \[name] failed N times in a row"* and links directly to the workflow's analytics page.

### Configuring notifications

There are two places where you can configure this:

#### 1. Account Settings → Notifications

**Where:** Click your avatar → Settings → Notifications

This is the global configuration for your organization. It controls two things:

* **Channels** — whether alerts are sent via Email, In-App, or both. Toggle these on or off per notification type in the table.
* **Threshold** — the number of consecutive failures before an alert fires. Click **Manage** (admins only) next to *Workflow Error* to change it from the default of 3.

Admins see two tabs:

* **Organization** — sets the defaults that apply to all workflows and all members. Only admins can edit this.
* **Personal** — lets each user override which channels they receive notifications on, regardless of the org default.

Non-admins only see the Personal tab.

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

#### 2. Workflow Settings → Workflow Notifications

**Where:** Open a workflow → Settings icon (top-right) → Workflow Notifications tab

This lets you set a **per-workflow threshold** that overrides the org-level default for that specific workflow. For example, if the org default is 3 but this workflow is customer-facing, you can set it to 1 to be alerted on the first failure.

Click **Manage** next to *Workflow Error* to set the threshold for this workflow.

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

{% hint style="info" %}
The per-workflow threshold only overrides the *when* — the channels (Email, In-App) are always controlled from Account Settings.
{% endhint %}

### Who gets notified

By default, notifications are sent to the **project creator** and all **organization admins**.

You can customize this from the **Manage** dialog in either the Account Settings or the Workflow Settings (described above). Both dialogs include a **Users to notify** field where you can select specific members of your organization. When set, notifications go to those users instead of the default recipients.


---

# 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.stackai.com/welcome-to-stackai/security-and-governance/security-in-stackai/workflow-notifications.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.