---
title: "render.failed"
method: POST
path: "render.failed"
tags: ["Webhooks"]
---

# render.failed

`POST render.failed` (webhook)

An API render failed: compilation error, storage failure, or an async job that exhausted its retries. Same delivery and signature rules as `render.completed`.

## Headers

- `webhook-id` string, required
- `webhook-timestamp` string, required
- `webhook-signature` string, required

## Payload

- RenderEvent
  - `id` string, required: Unique per delivery (`evt_...`).
  - `type` 'render.completed' | 'render.failed', required
  - `createdAt` string, date-time, required
  - `data` object, required
    - `renderId` string, required: The render log id.
    - `jobId` string: Async renders only.
    - `organizationId` string, required
    - `templateExternalId` string
    - `status` 'success' | 'error', required
    - `durationMs` integer
    - `errorMessage` string: `render.failed` only.
    - `downloadUrl` string, uri: Successful async renders only. Requires the API key.

## Acknowledgement `2XX`

Acknowledged.

---

[API](https://skmtc.dev/pdfs/apis/pdfs-build-api.md) · [All operations](https://skmtc.dev/pdfs/apis/pdfs-build-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pdfs/apis/pdfs-build-api/revisions/1c7340b9521d?raw)