> This page is for version v2026-02-09 (default).
> For other versions, use one of these documentation indexes:
> - v2026-02-09 (default): https://docs.extend.ai/2026-02-09/llms.txt
> - v2025-04-21: https://docs.extend.ai/2025-04-21/llms.txt
> - v2024-12-23: https://docs.extend.ai/2024-12-23/llms.txt

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.extend.ai/llms.txt
> Use this file to discover all available pages before exploring further.
>
> ## API version
> The current API version is `2026-02-09`, served at the site root (no version prefix in URLs).
> If this page URL contains `/2025-04-21/` or `/2024-12-23/`, you are reading an older API version.
> Prefer the current docs at https://docs.extend.ai/llms.txt unless the user explicitly needs that older version.
> Do not treat older-version pages as the source of truth for new integrations.

# Parse Run Failed

POST 

Reference: https://docs.extend.ai/api-reference/webhook-events/parse/parse-run-failed-webhook

## Request

### Payload

- `eventId` (string, required) — Unique identifier for the event
- `payload` (ParseRunStatus, required) — Minimal parse run status object sent in webhook notifications. Contains only the essential status information, without the full output data.

## Types

### ParseRunStatus

Minimal parse run status object sent in webhook notifications. Contains only the essential status information, without the full output data.

- `object` (enum, required) — The type of object. Will always be `"parse_run_status"`.
  - Allowed values: `parse_run_status`
- `id` (string, required) — A unique identifier for the parse run. Example: `"pr_xK9mLPqRtN3vS8wF5hB2cQ"`
- `status` (enum, required) — The status of the parse run: * `"PROCESSING"` - The file is still being processed * `"PROCESSED"` - The file was successfully processed * `"FAILED"` - The processing failed (see `failureReason` for details)
  - Allowed values: `PROCESSING`, `PROCESSED`, `FAILED`
- `failureReason` (string, required, nullable) — The reason for failure. **Availability:** Present when `status` is `"FAILED"`.
- `failureMessage` (string, optional, nullable) — A human-readable description of the failure. **Availability:** Present when `status` is `"FAILED"`.
- `metadata` (map from string to any, optional, nullable) — Any metadata that was provided when creating the parse run. **Availability:** Present when metadata was provided during creation.