---
title: "Video transformation error"
method: POST
path: "video.transformation.error"
---

# Video transformation error

`POST video.transformation.error` (webhook)

Triggered when a video transformation fails during processing. Listen to this webhook to log the error reason and take appropriate action. Check your origin and URL endpoint settings if the reason is related to download failure.

## Payload

- VideoTransformationErrorEvent — Triggered when an error occurs during video encoding. Listen to this webhook to log error reasons and debug issues. Check your origin and URL endpoint settings if the reason is related to download failure. For other errors, contact ImageKit support.
  - `id` string, required — Unique identifier for the event.
  - `type` 'video.transformation.error', required — The type of webhook event.
  - `created_at` string, date-time, required — Timestamp when the event was created in ISO8601 format.
  - `request` VideoWebhookRequestInfo, required — Information about the original request that triggered the video transformation.
    - `x_request_id` string, required — Unique identifier for the originating transformation request.
    - `url` string, uri, required — Full URL of the transformation request that was submitted.
    - `user_agent` string — User-Agent header from the original request that triggered the transformation.
  - `data` object, required
    - `asset` VideoAsset, required — Information about the source video asset being transformed.
      - `url` string, uri, required — URL to download or access the source video file.
    - `transformation` object, required — Base information about a video transformation request.
      - `type` 'video-transformation' | 'gif-to-video' | 'video-thumbnail', required — Type of video transformation: - `video-transformation`: Standard video processing (resize, format conversion, etc.) - `gif-to-video`: Convert animated GIF to video format - `video-thumbnail`: Generate thumbnail image from video
      - `options` VideoTransformationOptions — Configuration options for video transformations.
        - `video_codec` 'h264' | 'vp9' | 'av1' — Video codec used for encoding (h264, vp9, or av1).
        - `audio_codec` 'aac' | 'opus' — Audio codec used for encoding (aac or opus).
        - `auto_rotate` boolean — Whether to automatically rotate the video based on metadata.
        - `quality` integer — Quality setting for the output video.
        - `format` 'mp4' | 'webm' | 'jpg' | 'png' | 'webp' — Output format for the transformed video or thumbnail.
        - `stream_protocol` 'HLS' | 'DASH' — Streaming protocol for adaptive bitrate streaming.
        - `variants` string[] — Array of quality representations for adaptive bitrate streaming.
      - `error` object — Details about the transformation error.
        - `reason` 'encoding_failed' | 'download_failed' | 'internal_server_error', required — Specific reason for the transformation failure: - `encoding_failed`: Error during video encoding process - `download_failed`: Could not download source video - `internal_server_error`: Unexpected server error

## 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)