---
title: "Fired when a job reaches the `failed` terminal state."
method: POST
path: "jobFailed"
tags: ["Webhooks"]
---

# Fired when a job reaches the \`failed\` terminal state.

`POST jobFailed` (webhook)

## Headers

- `OnPage-Event` string, required
- `OnPage-Delivery-Id` string, required
- `OnPage-Timestamp` string, required
- `OnPage-Signature` string, required

## Payload

- union: Outbound delivery body for the `job.failed` event. `attempt` is one-based; `will_retry` is false on terminal emissions.
  - object
    - `job_id` string, required
    - `api_key_id` string
    - `request_id` string, required
    - `type` 'classify', required
    - `status` 'failed', required
    - `failed_at` string, required
    - `error` object, required
      - `code` string, required
      - `message` string, required
    - `attempt` integer, required
    - `will_retry` boolean, required
  - object
    - `job_id` string, required
    - `api_key_id` string
    - `request_id` string, required
    - `type` 'scan', required
    - `callback_metadata` object
    - `status` 'failed', required
    - `failed_at` string, required
    - `error` object, required
      - `code` string, required
      - `message` string, required
    - `attempt` integer, required
    - `will_retry` boolean, required

## Acknowledgement `200`

Ack. Any 2xx is accepted.

---

[API](https://skmtc.dev/on-page/apis/on-page-ai-api.md) - [All operations](https://skmtc.dev/on-page/apis/on-page-ai-api/llms.txt) - [OpenAPI document](https://skmtc.dev/on-page/apis/on-page-ai-api/revisions/a081e8701c19?raw)