job.failed

Sent when a job fails. For generate jobs there is NO operation field; cover-operation jobs include it. Reserved credits are refunded on failure.

postWebhookjobFailed

Payload

event'job.failed' required
jobIdstring uuid required
external_refstring nullable required
status'failed' required
operation'variation' | 'edit_image' | 'upscale' | 'audiobook_cover' | 'remove_text' | 'generate_reference' | 'wrap' | 'wrap_extend_front'

Present on every job's webhook except generate, whose webhooks omit this field.

timestampstring date-time required
errorstring required

Failure message.

Response

Return any 2xx to acknowledge receipt.

Changes

Webhooks have no change history: a webhook is keyed by its event name rather than a path and method, so no recorded change can name it.