---
title: "Post-transformation error"
method: POST
path: "upload.post-transform.error"
---

# Post-transformation error

`POST upload.post-transform.error` (webhook)

Triggered when a post-transformation fails. The original file remains available in the Media Library, but the requested transformation could not be generated. Review the error reason to determine the cause of failure.

## Payload

- UploadPostTransformErrorEvent — Triggered when a post-transformation fails. The original file remains available, but the requested transformation could not be generated.
  - `id` string, required — Unique identifier for the event.
  - `type` 'upload.post-transform.error', required — The type of webhook event.
  - `created_at` string, date-time, required — Timestamp of when the event occurred in ISO8601 format.
  - `request` PostTransformWebhookRequestInfo, required
    - `x_request_id` string, required — Unique identifier for the originating request.
    - `transformation` object, required
      - `type` 'transformation' | 'abs' | 'gif-to-video' | 'thumbnail', required — Type of the requested post-transformation.
      - `value` string — Value for the requested transformation type.
      - `protocol` 'hls' | 'dash' — Only applicable if transformation type is 'abs'. Streaming protocol used.
  - `data` object, required
    - `fileId` string, required — Unique identifier of the originally uploaded file.
    - `url` string, uri, required — URL of the attempted post-transformation.
    - `name` string, required — Name of the file.
    - `path` string, required — Path of the file.
    - `transformation` object, required
      - `error` object, required
        - `reason` string, required — Reason for the post-transformation failure.

## Acknowledgement `200`

Acknowledge

---

[API](https://skmtc.dev/imagekit-developer/apis/imagekit-api.md) · [All operations](https://skmtc.dev/imagekit-developer/apis/imagekit-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/imagekit-developer/imagekit-api/revisions/bb3e9ff84b3e/schema)