---
title: "Pre-transformation error"
method: POST
path: "upload.pre-transform.error"
---

# Pre-transformation error

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

Triggered when a pre-transformation fails. The original file upload may have been accepted, but the requested transformation could not be applied. Review the error reason to understand what went wrong.

## Payload

- UploadPreTransformErrorEvent — Triggered when a pre-transformation fails. The file upload may have been accepted, but the requested transformation could not be applied.
  - `id` string, required — Unique identifier for the event.
  - `type` 'upload.pre-transform.error', required — The type of webhook event.
  - `created_at` string, date-time, required — Timestamp of when the event occurred in ISO8601 format.
  - `request` PreTransformWebhookRequestInfo, required
    - `x_request_id` string, required — Unique identifier for the originating request.
    - `transformation` string, required — The requested pre-transformation string.
  - `data` object, required
    - `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 pre-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)