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

# Video transformation ready

`POST video.transformation.ready` (webhook)

Triggered when video encoding is finished and the transformed resource is ready to be served. Listen to this webhook and update any flags in your database or CMS so your application can start displaying the transformed video to users.

## Payload

- VideoTransformationReadyEvent — Triggered when video encoding is finished and the transformed resource is ready to be served. This is the key event to listen for - update your database or CMS flags when you receive this so your application can start showing the transformed video to users.
  - `id` string, required — Unique identifier for the event.
  - `type` 'video.transformation.ready', 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.
  - `timings` object — Performance metrics for the transformation process.
    - `download_duration` integer — Time spent downloading the source video from your origin or media library, in milliseconds.
    - `encoding_duration` integer — Time spent encoding the video, in milliseconds.
  - `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.
      - `output` object — Information about the transformed output video.
        - `url` string, uri, required — URL to access the transformed video.
        - `video_metadata` object — Metadata of the output video file.
          - `duration` number, required — Duration of the output video in seconds.
          - `width` integer, required — Width of the output video in pixels.
          - `height` integer, required — Height of the output video in pixels.
          - `bitrate` integer, required — Bitrate of the output video in bits per second.

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