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

# run.failed

> A run failed. `data.error.code` names the failure category; get the run for its details.

Sent when a run fails. `error.code` is the failure category, the same value as the run's `error.code` in [get a run](/api-reference/get-run); the event never carries the error message, which can quote what a destination answered. Get the run for the message. See [events](/api-reference/events) for delivery, retries and [signatures](/api-reference/verifying-signatures).


## OpenAPI

````yaml webhook run.failed
openapi: 3.1.1
info:
  title: Ingestly API
  description: >-
    Public Ingestly API. Authenticate every request with an API key in the
    `X-Api-Key` header. A key belongs to one organization and carries scopes
    (such as `workflows:trigger` or `runs:read`); each operation requires one
    scope, and a key without it is rejected with 403. Errors use RFC 7807
    problem details.
  version: 1.0.0
servers:
  - url: https://api.ingestly.ai
security:
  - ApiKey: []
tags:
  - name: Workflows
  - name: Runs
  - name: Review Tasks
  - name: Events
  - name: Documents
paths: {}
components:
  securitySchemes:
    ApiKey:
      type: apiKey
      name: X-Api-Key
      in: header

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.