# reportExternalFailure

**Kind:** API Endpoint

**Source:** [`atloria-monorepo/apps/api/src/documentation/doc-automation.controller.ts`](https://github.com/sherkety/atloria/blob/main/atloria-monorepo/apps/api/src/documentation/doc-automation.controller.ts#L233)

Report a TERMINAL failure for an externally-driven job (atlorix-runner)

## Endpoint

`POST /doc-automation/jobs/:id/external-failed`

| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
| `id` | path | `string` | ✓ | Job ID |

## Referenced By

- `DocAutomationController` (MODULE_DECLARES)