> ## Documentation Index
> Fetch the complete documentation index at: https://docs.clustr-ai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Failed Run Alerts

> Whether you are emailed when a workflow fails, and who receives it

Read the failed-run alert setting: whether an email goes out when a workflow fails, whether
the workflow's owner gets it, and the extra addresses it also goes to. Change it with
[Update Failed Run Alerts](/api-reference/update-failed-run-alerts).

<Info>
  **On by default.** A workspace that never saved the setting reads as `enabled: true`,
  `notify_defaults: true`, no extra recipients, and `is_default: true`. The owner of a
  workflow is whoever last turned it on, else whoever created it. When neither is recorded,
  or that person is no longer a member of the workspace, the email goes to the workspace
  admins.
</Info>

## Query

<ParamField query="workflow_id" type="string">
  Optional. Also returns `workflow`: who that workflow's failure email goes to today, with
  its owner (or `null` for the workspace admins), the admins, and the full recipient list.
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.clustr-ai.com/api/public/notifications/failed-runs?workflow_id=7b1c2f0e-4a8e-4d59-9b1a-2f0c8e6d1a33" \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```

  ```python Python theme={null}
  import requests

  requests.get(
      "https://api.clustr-ai.com/api/public/notifications/failed-runs",
      headers={"Authorization": "Bearer YOUR_API_KEY"},
      params={"workflow_id": "7b1c2f0e-4a8e-4d59-9b1a-2f0c8e6d1a33"},
  )
  ```

  ```javascript JavaScript theme={null}
  await fetch("https://api.clustr-ai.com/api/public/notifications/failed-runs?workflow_id=7b1c2f0e-4a8e-4d59-9b1a-2f0c8e6d1a33", {
    headers: { Authorization: "Bearer YOUR_API_KEY" },
  });
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "data": {
      "enabled": true,
      "notify_defaults": true,
      "recipients": ["ops@example.com"],
      "is_default": false,
      "updated_at": "2026-09-18T09:12:44Z",
      "workflow": {
        "workflow_id": "7b1c2f0e-4a8e-4d59-9b1a-2f0c8e6d1a33",
        "owner": { "user_id": "3f7a9d2e-0c4b-4e1f-8a6d-5b2c9e1f0a47", "email": "marine.b@example.com", "name": "Marine B" },
        "owner_source": "enabled_by",
        "admins": [{ "user_id": "9a1e4c7b-2d3f-4b8a-9c6e-1f0d2a3b4c5d", "email": "admin@example.com", "name": "Sam Admin" }],
        "recipients": ["marine.b@example.com", "ops@example.com"]
      }
    }
  }
  ```
</ResponseExample>