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

# Error workflows

> Run a Tracecat workflow whenever another workflow fails: forward error context, alert on-call, and centralize incident-handling logic across automations.

## Overview

Error workflows run when another workflow fails with an application error.

<img src="https://mintcdn.com/tracecat/9IEnC4OWdnuB3EvN/img/triggers/failed-workflow.png?fit=max&auto=format&n=9IEnC4OWdnuB3EvN&q=85&s=20c81728fcfef2d3c8c41821b5fd1575" alt="Failed workflow" width="3440" height="1906" data-path="img/triggers/failed-workflow.png" />

## Trigger payload

The failed run is passed into the error workflow under `${{ TRIGGER }}`.

Fields:

* `${{ TRIGGER.message }}`: the top-level failure message.
* `${{ TRIGGER.orig_wf_id }}`: the failed workflow ID.
* `${{ TRIGGER.orig_wf_exec_id }}`: the failed workflow execution ID.
* `${{ TRIGGER.orig_wf_exec_url }}`: the failed workflow execution URL, if available.
* `${{ TRIGGER.orig_wf_title }}`: the failed workflow title.
* `${{ TRIGGER.trigger_type }}`: the original trigger type.
* `${{ TRIGGER.errors }}`: structured action error details, if available.

Example payload:

```json theme={null}
{
  "message": "Action failed",
  "handler_wf_id": "wf_4itKqkgCZrLhgYiq5L211X",
  "orig_wf_id": "wf_3mYp8JkL2nQr7sTu9vWx0Z",
  "orig_wf_exec_id": "wf_3mYp8JkL2nQr7sTu9vWx0Z/exec_7aBcDeFgHiJkLmNoPqRsTu",
  "orig_wf_exec_url": "https://platform.tracecat.com/workspaces/ws_2xYzAbCdEfGhJkLmNoPqRs/workflows/wf_3mYp8JkL2nQr7sTu9vWx0Z/executions/exec_7aBcDeFgHiJkLmNoPqRsTu",
  "orig_wf_title": "Investigate alert",
  "trigger_type": "webhook",
  "errors": [
    {
      "ref": "fetch_alert",
      "message": "Request returned 500",
      "type": "HTTPError"
    }
  ]
}
```

## Configure an error workflow

Set `Error workflow` in the workflow settings panel. Use a workflow ID or alias.

<img src="https://mintcdn.com/tracecat/9IEnC4OWdnuB3EvN/img/triggers/error-workflow.png?fit=max&auto=format&n=9IEnC4OWdnuB3EvN&q=85&s=64d4d4f7f85a2b5712778331aa8d6547" alt="Error workflow" width="3440" height="1906" data-path="img/triggers/error-workflow.png" />

## Publish behavior

The workflow must be published for the committed error workflow setting to apply to published runs and schedules.