imagekitio 4.9.0 → 4.11.0

data/lib/imagekitio/models/transformation.rb

@@ -201,6 +201,17 @@ module Imagekitio
       #   @return [String, nil]
       optional :default_image, String, api_name: :defaultImage
 
+      # @!attribute density
+      #   Sets the output image density in dots per inch (DPI). Accepts an integer from 1
+      #   to 1200 or an arithmetic expression using the `idn` variable, such as
+      #   `idn_mul_2`. For raster images, this updates density metadata without changing
+      #   dimensions. For vector images, it controls the DPI used during rasterization.
+      #   Cannot be used inside layers. See
+      #   [Density](https://imagekit.io/docs/image-optimization#density---dn).
+      #
+      #   @return [Integer, String, nil]
+      optional :density, union: -> { Imagekitio::Transformation::Density }
+
       # @!attribute distort
       #   Distorts the shape of an image. Supports two modes:
       #
@@ -510,7 +521,7 @@ module Imagekitio
       #   @return [Float, nil]
       optional :zoom, Float
 
-      # @!method initialize(ai_change_background: nil, ai_drop_shadow: nil, ai_edit: nil, ai_remove_background: nil, ai_remove_background_external: nil, ai_retouch: nil, ai_upscale: nil, ai_variation: nil, aspect_ratio: nil, audio_codec: nil, background: nil, blur: nil, border: nil, colorize: nil, color_profile: nil, color_replace: nil, contrast_stretch: nil, crop: nil, crop_mode: nil, default_image: nil, distort: nil, dpr: nil, duration: nil, end_offset: nil, flip: nil, focus: nil, format_: nil, gradient: nil, grayscale: nil, height: nil, lossless: nil, metadata: nil, named: nil, opacity: nil, original: nil, overlay: nil, page: nil, progressive: nil, quality: nil, radius: nil, raw: nil, rotation: nil, shadow: nil, sharpen: nil, start_offset: nil, streaming_resolutions: nil, trim: nil, unsharp_mask: nil, video_codec: nil, width: nil, x: nil, x_center: nil, y_: nil, y_center: nil, zoom: nil)
+      # @!method initialize(ai_change_background: nil, ai_drop_shadow: nil, ai_edit: nil, ai_remove_background: nil, ai_remove_background_external: nil, ai_retouch: nil, ai_upscale: nil, ai_variation: nil, aspect_ratio: nil, audio_codec: nil, background: nil, blur: nil, border: nil, colorize: nil, color_profile: nil, color_replace: nil, contrast_stretch: nil, crop: nil, crop_mode: nil, default_image: nil, density: nil, distort: nil, dpr: nil, duration: nil, end_offset: nil, flip: nil, focus: nil, format_: nil, gradient: nil, grayscale: nil, height: nil, lossless: nil, metadata: nil, named: nil, opacity: nil, original: nil, overlay: nil, page: nil, progressive: nil, quality: nil, radius: nil, raw: nil, rotation: nil, shadow: nil, sharpen: nil, start_offset: nil, streaming_resolutions: nil, trim: nil, unsharp_mask: nil, video_codec: nil, width: nil, x: nil, x_center: nil, y_: nil, y_center: nil, zoom: nil)
       #   Some parameter documentations has been truncated, see
       #   {Imagekitio::Models::Transformation} for more details.
       #
@@ -561,6 +572,8 @@ module Imagekitio
       #
       #   @param default_image [String] Specifies a fallback image if the resource is not found, e.g., a URL or file pat
       #
+      #   @param density [Integer, String] Sets the output image density in dots per inch (DPI). Accepts an integer from 1
+      #
       #   @param distort [String] Distorts the shape of an image. Supports two modes:
       #
       #   @param dpr [Float] Accepts values between 0.1 and 5, or `auto` for automatic device pixel ratio (DP
@@ -802,6 +815,25 @@ module Imagekitio
         #   @return [Array<Symbol>]
       end
 
+      # Sets the output image density in dots per inch (DPI). Accepts an integer from 1
+      # to 1200 or an arithmetic expression using the `idn` variable, such as
+      # `idn_mul_2`. For raster images, this updates density metadata without changing
+      # dimensions. For vector images, it controls the DPI used during rasterization.
+      # Cannot be used inside layers. See
+      # [Density](https://imagekit.io/docs/image-optimization#density---dn).
+      #
+      # @see Imagekitio::Models::Transformation#density
+      module Density
+        extend Imagekitio::Internal::Type::Union
+
+        variant Integer
+
+        variant String
+
+        # @!method self.variants
+        #   @return [Array(Integer, String)]
+      end
+
       # Specifies the duration (in seconds) for trimming videos, e.g., `5` or `10.5`.
       # Typically used with startOffset to indicate the length from the start offset.
       # Arithmetic expressions are supported. See

data/lib/imagekitio/models/unsafe_unwrap_webhook_event.rb

@@ -46,8 +46,17 @@ module Imagekitio
       # Triggered when a file version is deleted.
       variant -> { Imagekitio::FileVersionDeleteEvent }
 
+      # Triggered when a folder is created, whether explicitly, by copying or moving a folder, or implicitly when an upload creates missing parent folders. Copying or moving a folder tree sends one event per folder in the tree.
+      variant -> { Imagekitio::FolderCreateEvent }
+
+      # Triggered when a folder is updated, for example when its custom metadata changes or it is renamed. Renaming a folder sends one event per folder in the tree, each with its new `folderPath`.
+      variant -> { Imagekitio::FolderUpdateEvent }
+
+      # Triggered when a folder is deleted. Deleting a folder tree sends one event per folder in the tree; the files inside it send `file.deleted` events and their versions send `file-version.deleted` events. Moving a folder sends this event for the old `folderId` and `folder.created` for the new one.
+      variant -> { Imagekitio::FolderDeleteEvent }
+
       # @!method self.variants
-      #   @return [Array(Imagekitio::Models::VideoTransformationAcceptedEvent, Imagekitio::Models::VideoTransformationReadyEvent, Imagekitio::Models::VideoTransformationErrorEvent, Imagekitio::Models::UploadPreTransformSuccessEvent, Imagekitio::Models::UploadPreTransformErrorEvent, Imagekitio::Models::UploadPostTransformSuccessEvent, Imagekitio::Models::UploadPostTransformErrorEvent, Imagekitio::Models::FileCreateEvent, Imagekitio::Models::FileUpdateEvent, Imagekitio::Models::FileDeleteEvent, Imagekitio::Models::FileVersionCreateEvent, Imagekitio::Models::FileVersionDeleteEvent)]
+      #   @return [Array(Imagekitio::Models::VideoTransformationAcceptedEvent, Imagekitio::Models::VideoTransformationReadyEvent, Imagekitio::Models::VideoTransformationErrorEvent, Imagekitio::Models::UploadPreTransformSuccessEvent, Imagekitio::Models::UploadPreTransformErrorEvent, Imagekitio::Models::UploadPostTransformSuccessEvent, Imagekitio::Models::UploadPostTransformErrorEvent, Imagekitio::Models::FileCreateEvent, Imagekitio::Models::FileUpdateEvent, Imagekitio::Models::FileDeleteEvent, Imagekitio::Models::FileVersionCreateEvent, Imagekitio::Models::FileVersionDeleteEvent, Imagekitio::Models::FolderCreateEvent, Imagekitio::Models::FolderUpdateEvent, Imagekitio::Models::FolderDeleteEvent)]
     end
   end
 end

data/lib/imagekitio/models/unwrap_webhook_event.rb

@@ -46,8 +46,17 @@ module Imagekitio
       # Triggered when a file version is deleted.
       variant -> { Imagekitio::FileVersionDeleteEvent }
 
+      # Triggered when a folder is created, whether explicitly, by copying or moving a folder, or implicitly when an upload creates missing parent folders. Copying or moving a folder tree sends one event per folder in the tree.
+      variant -> { Imagekitio::FolderCreateEvent }
+
+      # Triggered when a folder is updated, for example when its custom metadata changes or it is renamed. Renaming a folder sends one event per folder in the tree, each with its new `folderPath`.
+      variant -> { Imagekitio::FolderUpdateEvent }
+
+      # Triggered when a folder is deleted. Deleting a folder tree sends one event per folder in the tree; the files inside it send `file.deleted` events and their versions send `file-version.deleted` events. Moving a folder sends this event for the old `folderId` and `folder.created` for the new one.
+      variant -> { Imagekitio::FolderDeleteEvent }
+
       # @!method self.variants
-      #   @return [Array(Imagekitio::Models::VideoTransformationAcceptedEvent, Imagekitio::Models::VideoTransformationReadyEvent, Imagekitio::Models::VideoTransformationErrorEvent, Imagekitio::Models::UploadPreTransformSuccessEvent, Imagekitio::Models::UploadPreTransformErrorEvent, Imagekitio::Models::UploadPostTransformSuccessEvent, Imagekitio::Models::UploadPostTransformErrorEvent, Imagekitio::Models::FileCreateEvent, Imagekitio::Models::FileUpdateEvent, Imagekitio::Models::FileDeleteEvent, Imagekitio::Models::FileVersionCreateEvent, Imagekitio::Models::FileVersionDeleteEvent)]
+      #   @return [Array(Imagekitio::Models::VideoTransformationAcceptedEvent, Imagekitio::Models::VideoTransformationReadyEvent, Imagekitio::Models::VideoTransformationErrorEvent, Imagekitio::Models::UploadPreTransformSuccessEvent, Imagekitio::Models::UploadPreTransformErrorEvent, Imagekitio::Models::UploadPostTransformSuccessEvent, Imagekitio::Models::UploadPostTransformErrorEvent, Imagekitio::Models::FileCreateEvent, Imagekitio::Models::FileUpdateEvent, Imagekitio::Models::FileDeleteEvent, Imagekitio::Models::FileVersionCreateEvent, Imagekitio::Models::FileVersionDeleteEvent, Imagekitio::Models::FolderCreateEvent, Imagekitio::Models::FolderUpdateEvent, Imagekitio::Models::FolderDeleteEvent)]
     end
   end
 end

data/lib/imagekitio/models/update_file_request.rb

@@ -23,6 +23,11 @@ module Imagekitio
         #   value for that key. Before setting any custom metadata on an asset you have to
         #   create the field using custom metadata fields API.
         #
+        #   To preserve the original creation date of an asset migrated from another system,
+        #   set the reserved `_internal_original_created_datetime` key to an ISO 8601 date
+        #   string. This key is available once the original creation date setting is enabled
+        #   in the media library settings.
+        #
         #   @return [Hash{Symbol=>Object}, nil]
         optional :custom_metadata,
                  Imagekitio::Internal::Type::HashOf[Imagekitio::Internal::Type::Unknown],

data/lib/imagekitio/models.rb

@@ -108,8 +108,12 @@ module Imagekitio
 
   FolderCopyParams = Imagekitio::Models::FolderCopyParams
 
+  FolderCreateEvent = Imagekitio::Models::FolderCreateEvent
+
   FolderCreateParams = Imagekitio::Models::FolderCreateParams
 
+  FolderDeleteEvent = Imagekitio::Models::FolderDeleteEvent
+
   FolderDeleteParams = Imagekitio::Models::FolderDeleteParams
 
   FolderMoveParams = Imagekitio::Models::FolderMoveParams
@@ -118,6 +122,8 @@ module Imagekitio
 
   Folders = Imagekitio::Models::Folders
 
+  FolderUpdateEvent = Imagekitio::Models::FolderUpdateEvent
+
   GetImageAttributesOptions = Imagekitio::Models::GetImageAttributesOptions
 
   ImageOverlay = Imagekitio::Models::ImageOverlay

data/lib/imagekitio/resources/accounts/webhooks.rb

@@ -0,0 +1,146 @@
+# frozen_string_literal: true
+
+module Imagekitio
+  module Resources
+    class Accounts
+      class Webhooks
+        # Some parameter documentations has been truncated, see
+        # {Imagekitio::Models::Accounts::WebhookCreateParams} for more details.
+        #
+        # Creates a new webhook and returns the created object, including the generated
+        # signing `secret`.
+        #
+        # ImageKit sends a `POST` request to the webhook `endpoint` whenever one of the
+        # subscribed `events` occurs. Use the `secret` to verify the signature of each
+        # request. Learn more about [webhooks](https://imagekit.io/docs/webhooks).
+        #
+        # You can create up to 3 webhooks per account.
+        #
+        # @overload create(endpoint:, events:, enabled: nil, request_options: {})
+        #
+        # @param endpoint [String] The URL where ImageKit sends webhook events as `POST` requests. Must use the `ht
+        #
+        # @param events [Array<Symbol, Imagekitio::Models::Accounts::WebhookEventType>] The event types this webhook is subscribed to. ImageKit sends a request to the `
+        #
+        # @param enabled [Boolean] Whether the webhook is enabled. When `false`, ImageKit doesn't send any events t
+        #
+        # @param request_options [Imagekitio::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Imagekitio::Models::Accounts::Webhook]
+        #
+        # @see Imagekitio::Models::Accounts::WebhookCreateParams
+        def create(params)
+          parsed, options = Imagekitio::Accounts::WebhookCreateParams.dump_request(params)
+          @client.request(
+            method: :post,
+            path: "v1/accounts/webhooks",
+            body: parsed,
+            model: Imagekitio::Accounts::Webhook,
+            options: options
+          )
+        end
+
+        # Some parameter documentations has been truncated, see
+        # {Imagekitio::Models::Accounts::WebhookUpdateParams} for more details.
+        #
+        # Updates the webhook identified by `id` and returns the updated object. Only the
+        # fields included in the request body are changed.
+        #
+        # When `events` is provided, it replaces the existing list of subscribed events.
+        # The signing `secret` can't be changed.
+        #
+        # @overload update(id, enabled: nil, endpoint: nil, events: nil, request_options: {})
+        #
+        # @param id [String] Unique identifier for a webhook.
+        #
+        # @param enabled [Boolean] Whether the webhook is enabled. Omit to leave the current value unchanged.
+        #
+        # @param endpoint [String] The URL where ImageKit sends webhook events as `POST` requests. Must use the `ht
+        #
+        # @param events [Array<Symbol, Imagekitio::Models::Accounts::WebhookEventType>] The event types this webhook is subscribed to. Replaces the existing list. Omit
+        #
+        # @param request_options [Imagekitio::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Imagekitio::Models::Accounts::Webhook]
+        #
+        # @see Imagekitio::Models::Accounts::WebhookUpdateParams
+        def update(id, params = {})
+          parsed, options = Imagekitio::Accounts::WebhookUpdateParams.dump_request(params)
+          @client.request(
+            method: :patch,
+            path: ["v1/accounts/webhooks/%1$s", id],
+            body: parsed,
+            model: Imagekitio::Accounts::Webhook,
+            options: options
+          )
+        end
+
+        # Returns an array of all webhooks configured for your account.
+        #
+        # @overload list(request_options: {})
+        #
+        # @param request_options [Imagekitio::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Array<Imagekitio::Models::Accounts::Webhook>]
+        #
+        # @see Imagekitio::Models::Accounts::WebhookListParams
+        def list(params = {})
+          @client.request(
+            method: :get,
+            path: "v1/accounts/webhooks",
+            model: Imagekitio::Internal::Type::ArrayOf[Imagekitio::Accounts::Webhook],
+            options: params[:request_options]
+          )
+        end
+
+        # Permanently deletes the webhook identified by `id`. ImageKit stops sending
+        # events to its endpoint.
+        #
+        # @overload delete(id, request_options: {})
+        #
+        # @param id [String] Unique identifier for a webhook.
+        #
+        # @param request_options [Imagekitio::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [nil]
+        #
+        # @see Imagekitio::Models::Accounts::WebhookDeleteParams
+        def delete(id, params = {})
+          @client.request(
+            method: :delete,
+            path: ["v1/accounts/webhooks/%1$s", id],
+            model: NilClass,
+            options: params[:request_options]
+          )
+        end
+
+        # Retrieves the webhook identified by `id`.
+        #
+        # @overload get(id, request_options: {})
+        #
+        # @param id [String] Unique identifier for a webhook.
+        #
+        # @param request_options [Imagekitio::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Imagekitio::Models::Accounts::Webhook]
+        #
+        # @see Imagekitio::Models::Accounts::WebhookGetParams
+        def get(id, params = {})
+          @client.request(
+            method: :get,
+            path: ["v1/accounts/webhooks/%1$s", id],
+            model: Imagekitio::Accounts::Webhook,
+            options: params[:request_options]
+          )
+        end
+
+        # @api private
+        #
+        # @param client [Imagekitio::Client]
+        def initialize(client:)
+          @client = client
+        end
+      end
+    end
+  end
+end

data/lib/imagekitio/resources/accounts.rb

@@ -15,6 +15,9 @@ module Imagekitio
       # @return [Imagekitio::Resources::Accounts::URLEndpoints]
       attr_reader :url_endpoints
 
+      # @return [Imagekitio::Resources::Accounts::Webhooks]
+      attr_reader :webhooks
+
       # @api private
       #
       # @param client [Imagekitio::Client]
@@ -24,6 +27,7 @@ module Imagekitio
         @usage_analytics = Imagekitio::Resources::Accounts::UsageAnalytics.new(client: client)
         @origins = Imagekitio::Resources::Accounts::Origins.new(client: client)
         @url_endpoints = Imagekitio::Resources::Accounts::URLEndpoints.new(client: client)
+        @webhooks = Imagekitio::Resources::Accounts::Webhooks.new(client: client)
       end
     end
   end

data/lib/imagekitio/resources/custom_metadata_fields.rb

@@ -116,14 +116,14 @@ module Imagekitio
       #
       # @param request_options [Imagekitio::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      # @return [Imagekitio::Models::CustomMetadataFieldDeleteResponse]
+      # @return [nil]
       #
       # @see Imagekitio::Models::CustomMetadataFieldDeleteParams
       def delete(id, params = {})
         @client.request(
           method: :delete,
           path: ["v1/customMetadataFields/%1$s", id],
-          model: Imagekitio::Models::CustomMetadataFieldDeleteResponse,
+          model: NilClass,
           options: params[:request_options]
         )
       end

data/lib/imagekitio/resources/files/versions.rb

@@ -43,7 +43,7 @@ module Imagekitio
         #
         # @param request_options [Imagekitio::RequestOptions, Hash{Symbol=>Object}, nil]
         #
-        # @return [Imagekitio::Models::Files::VersionDeleteResponse]
+        # @return [nil]
         #
         # @see Imagekitio::Models::Files::VersionDeleteParams
         def delete(version_id, params)
@@ -55,7 +55,7 @@ module Imagekitio
           @client.request(
             method: :delete,
             path: ["v1/files/%1$s/versions/%2$s", file_id, version_id],
-            model: Imagekitio::Models::Files::VersionDeleteResponse,
+            model: NilClass,
             options: options
           )
         end

data/lib/imagekitio/resources/files.rb

@@ -87,18 +87,12 @@ module Imagekitio
       #
       # @param request_options [Imagekitio::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      # @return [Imagekitio::Models::FileCopyResponse]
+      # @return [nil]
       #
       # @see Imagekitio::Models::FileCopyParams
       def copy(params)
         parsed, options = Imagekitio::FileCopyParams.dump_request(params)
-        @client.request(
-          method: :post,
-          path: "v1/files/copy",
-          body: parsed,
-          model: Imagekitio::Models::FileCopyResponse,
-          options: options
-        )
+        @client.request(method: :post, path: "v1/files/copy", body: parsed, model: NilClass, options: options)
       end
 
       # Some parameter documentations has been truncated, see
@@ -141,18 +135,12 @@ module Imagekitio
       #
       # @param request_options [Imagekitio::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      # @return [Imagekitio::Models::FileMoveResponse]
+      # @return [nil]
       #
       # @see Imagekitio::Models::FileMoveParams
       def move(params)
         parsed, options = Imagekitio::FileMoveParams.dump_request(params)
-        @client.request(
-          method: :post,
-          path: "v1/files/move",
-          body: parsed,
-          model: Imagekitio::Models::FileMoveResponse,
-          options: options
-        )
+        @client.request(method: :post, path: "v1/files/move", body: parsed, model: NilClass, options: options)
       end
 
       # Some parameter documentations has been truncated, see

data/lib/imagekitio/resources/folders.rb

@@ -46,18 +46,12 @@ module Imagekitio
       #
       # @param request_options [Imagekitio::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      # @return [Imagekitio::Models::FolderDeleteResponse]
+      # @return [nil]
       #
       # @see Imagekitio::Models::FolderDeleteParams
       def delete(params)
         parsed, options = Imagekitio::FolderDeleteParams.dump_request(params)
-        @client.request(
-          method: :delete,
-          path: "v1/folder",
-          body: parsed,
-          model: Imagekitio::Models::FolderDeleteResponse,
-          options: options
-        )
+        @client.request(method: :delete, path: "v1/folder", body: parsed, model: NilClass, options: options)
       end
 
       # Some parameter documentations has been truncated, see

data/lib/imagekitio/resources/webhooks.rb

@@ -5,7 +5,7 @@ module Imagekitio
     class Webhooks
       # @param payload [String] The raw webhook payload as a string
       #
-      # @return [Imagekitio::Models::VideoTransformationAcceptedEvent, Imagekitio::Models::VideoTransformationReadyEvent, Imagekitio::Models::VideoTransformationErrorEvent, Imagekitio::Models::UploadPreTransformSuccessEvent, Imagekitio::Models::UploadPreTransformErrorEvent, Imagekitio::Models::UploadPostTransformSuccessEvent, Imagekitio::Models::UploadPostTransformErrorEvent, Imagekitio::Models::FileCreateEvent, Imagekitio::Models::FileUpdateEvent, Imagekitio::Models::FileDeleteEvent, Imagekitio::Models::FileVersionCreateEvent, Imagekitio::Models::FileVersionDeleteEvent]
+      # @return [Imagekitio::Models::VideoTransformationAcceptedEvent, Imagekitio::Models::VideoTransformationReadyEvent, Imagekitio::Models::VideoTransformationErrorEvent, Imagekitio::Models::UploadPreTransformSuccessEvent, Imagekitio::Models::UploadPreTransformErrorEvent, Imagekitio::Models::UploadPostTransformSuccessEvent, Imagekitio::Models::UploadPostTransformErrorEvent, Imagekitio::Models::FileCreateEvent, Imagekitio::Models::FileUpdateEvent, Imagekitio::Models::FileDeleteEvent, Imagekitio::Models::FileVersionCreateEvent, Imagekitio::Models::FileVersionDeleteEvent, Imagekitio::Models::FolderCreateEvent, Imagekitio::Models::FolderUpdateEvent, Imagekitio::Models::FolderDeleteEvent]
       def unsafe_unwrap(payload)
         parsed = JSON.parse(payload, symbolize_names: true)
         Imagekitio::Internal::Type::Converter.coerce(Imagekitio::Models::UnsafeUnwrapWebhookEvent, parsed)
@@ -17,7 +17,7 @@ module Imagekitio
       #
       # @param key [String, nil] The webhook signing key
       #
-      # @return [Imagekitio::Models::VideoTransformationAcceptedEvent, Imagekitio::Models::VideoTransformationReadyEvent, Imagekitio::Models::VideoTransformationErrorEvent, Imagekitio::Models::UploadPreTransformSuccessEvent, Imagekitio::Models::UploadPreTransformErrorEvent, Imagekitio::Models::UploadPostTransformSuccessEvent, Imagekitio::Models::UploadPostTransformErrorEvent, Imagekitio::Models::FileCreateEvent, Imagekitio::Models::FileUpdateEvent, Imagekitio::Models::FileDeleteEvent, Imagekitio::Models::FileVersionCreateEvent, Imagekitio::Models::FileVersionDeleteEvent]
+      # @return [Imagekitio::Models::VideoTransformationAcceptedEvent, Imagekitio::Models::VideoTransformationReadyEvent, Imagekitio::Models::VideoTransformationErrorEvent, Imagekitio::Models::UploadPreTransformSuccessEvent, Imagekitio::Models::UploadPreTransformErrorEvent, Imagekitio::Models::UploadPostTransformSuccessEvent, Imagekitio::Models::UploadPostTransformErrorEvent, Imagekitio::Models::FileCreateEvent, Imagekitio::Models::FileUpdateEvent, Imagekitio::Models::FileDeleteEvent, Imagekitio::Models::FileVersionCreateEvent, Imagekitio::Models::FileVersionDeleteEvent, Imagekitio::Models::FolderCreateEvent, Imagekitio::Models::FolderUpdateEvent, Imagekitio::Models::FolderDeleteEvent]
       def unwrap(payload, headers:, key: @client.webhook_secret)
         if key.nil?
           raise ArgumentError.new("Cannot verify a webhook without a key on either the client's webhook_secret or passed in as an argument")

data/lib/imagekitio/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Imagekitio
-  VERSION = "4.9.0"
+  VERSION = "4.11.0"
 end

data/lib/imagekitio.rb

@@ -79,6 +79,14 @@ require_relative "imagekitio/models/accounts/usage_analytics_get_params"
 require_relative "imagekitio/models/accounts/usage_analytics_response"
 require_relative "imagekitio/models/accounts/usage_get_params"
 require_relative "imagekitio/models/accounts/usage_get_response"
+require_relative "imagekitio/models/accounts/webhook"
+require_relative "imagekitio/models/accounts/webhook_create_params"
+require_relative "imagekitio/models/accounts/webhook_delete_params"
+require_relative "imagekitio/models/accounts/webhook_event_type"
+require_relative "imagekitio/models/accounts/webhook_get_params"
+require_relative "imagekitio/models/accounts/webhook_list_params"
+require_relative "imagekitio/models/accounts/webhook_list_response"
+require_relative "imagekitio/models/accounts/webhook_update_params"
 require_relative "imagekitio/models/ai_tag"
 require_relative "imagekitio/models/asset_list_params"
 require_relative "imagekitio/models/asset_list_response"
@@ -92,7 +100,6 @@ require_relative "imagekitio/models/custom_metadata"
 require_relative "imagekitio/models/custom_metadata_field"
 require_relative "imagekitio/models/custom_metadata_field_create_params"
 require_relative "imagekitio/models/custom_metadata_field_delete_params"
-require_relative "imagekitio/models/custom_metadata_field_delete_response"
 require_relative "imagekitio/models/custom_metadata_field_list_params"
 require_relative "imagekitio/models/custom_metadata_field_list_response"
 require_relative "imagekitio/models/custom_metadata_field_update_params"
@@ -101,13 +108,11 @@ require_relative "imagekitio/models/extension_config"
 require_relative "imagekitio/models/extension_item"
 require_relative "imagekitio/models/extensions"
 require_relative "imagekitio/models/file_copy_params"
-require_relative "imagekitio/models/file_copy_response"
 require_relative "imagekitio/models/file_create_event"
 require_relative "imagekitio/models/file_delete_event"
 require_relative "imagekitio/models/file_delete_params"
 require_relative "imagekitio/models/file_get_params"
 require_relative "imagekitio/models/file_move_params"
-require_relative "imagekitio/models/file_move_response"
 require_relative "imagekitio/models/file_rename_params"
 require_relative "imagekitio/models/file_rename_response"
 require_relative "imagekitio/models/files/bulk_add_tags_params"
@@ -121,7 +126,6 @@ require_relative "imagekitio/models/files/bulk_remove_tags_response"
 require_relative "imagekitio/models/files/metadata_get_from_url_params"
 require_relative "imagekitio/models/files/metadata_get_params"
 require_relative "imagekitio/models/files/version_delete_params"
-require_relative "imagekitio/models/files/version_delete_response"
 require_relative "imagekitio/models/files/version_get_params"
 require_relative "imagekitio/models/files/version_list_params"
 require_relative "imagekitio/models/files/version_list_response"
@@ -136,16 +140,18 @@ require_relative "imagekitio/models/file_version_delete_event"
 require_relative "imagekitio/models/folder"
 require_relative "imagekitio/models/folder_copy_params"
 require_relative "imagekitio/models/folder_copy_response"
+require_relative "imagekitio/models/folder_create_event"
 require_relative "imagekitio/models/folder_create_params"
 require_relative "imagekitio/models/folder_create_response"
+require_relative "imagekitio/models/folder_delete_event"
 require_relative "imagekitio/models/folder_delete_params"
-require_relative "imagekitio/models/folder_delete_response"
 require_relative "imagekitio/models/folder_move_params"
 require_relative "imagekitio/models/folder_move_response"
 require_relative "imagekitio/models/folder_rename_params"
 require_relative "imagekitio/models/folder_rename_response"
 require_relative "imagekitio/models/folders/job_get_params"
 require_relative "imagekitio/models/folders/job_get_response"
+require_relative "imagekitio/models/folder_update_event"
 require_relative "imagekitio/models/get_image_attributes_options"
 require_relative "imagekitio/models/image_overlay"
 require_relative "imagekitio/models/metadata"
@@ -196,6 +202,7 @@ require_relative "imagekitio/resources/accounts/origins"
 require_relative "imagekitio/resources/accounts/url_endpoints"
 require_relative "imagekitio/resources/accounts/usage"
 require_relative "imagekitio/resources/accounts/usage_analytics"
+require_relative "imagekitio/resources/accounts/webhooks"
 require_relative "imagekitio/resources/assets"
 require_relative "imagekitio/resources/beta"
 require_relative "imagekitio/resources/beta/v2"

data/rbi/imagekitio/models/accounts/webhook.rbi

@@ -0,0 +1,109 @@
+# typed: strong
+
+module Imagekitio
+  module Models
+    module Accounts
+      class Webhook < Imagekitio::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(Imagekitio::Accounts::Webhook, Imagekitio::Internal::AnyHash)
+          end
+
+        # Unique identifier for a webhook.
+        sig { returns(String) }
+        attr_accessor :id
+
+        # ISO 8601 timestamp of when the webhook was created.
+        sig { returns(Time) }
+        attr_accessor :created_at
+
+        # Whether the webhook is enabled. When `false`, ImageKit doesn't send any events
+        # to the `endpoint`.
+        sig { returns(T::Boolean) }
+        attr_accessor :enabled
+
+        # The URL where ImageKit sends webhook events as `POST` requests. Must use the
+        # `http` or `https` protocol, and must be unique across all webhooks for your
+        # account.
+        sig { returns(String) }
+        attr_accessor :endpoint
+
+        # The event types this webhook is subscribed to. ImageKit sends a request to the
+        # `endpoint` only for these events.
+        sig do
+          returns(
+            T::Array[Imagekitio::Accounts::WebhookEventType::TaggedSymbol]
+          )
+        end
+        attr_accessor :events
+
+        # Signing secret generated by ImageKit, used to verify that webhook requests come
+        # from ImageKit. Starts with `whsec_`. This value can't be set or changed through
+        # the API. Learn more about
+        # [verifying webhook signatures](https://imagekit.io/docs/webhooks#verify-webhook-signature).
+        sig { returns(String) }
+        attr_accessor :secret
+
+        # ISO 8601 timestamp of when the webhook was last updated.
+        sig { returns(Time) }
+        attr_accessor :updated_at
+
+        # A webhook is an HTTP endpoint that ImageKit notifies when subscribed events
+        # occur in your account. Learn more about
+        # [webhooks](https://imagekit.io/docs/webhooks).
+        sig do
+          params(
+            id: String,
+            created_at: Time,
+            enabled: T::Boolean,
+            endpoint: String,
+            events: T::Array[Imagekitio::Accounts::WebhookEventType::OrSymbol],
+            secret: String,
+            updated_at: Time
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Unique identifier for a webhook.
+          id:,
+          # ISO 8601 timestamp of when the webhook was created.
+          created_at:,
+          # Whether the webhook is enabled. When `false`, ImageKit doesn't send any events
+          # to the `endpoint`.
+          enabled:,
+          # The URL where ImageKit sends webhook events as `POST` requests. Must use the
+          # `http` or `https` protocol, and must be unique across all webhooks for your
+          # account.
+          endpoint:,
+          # The event types this webhook is subscribed to. ImageKit sends a request to the
+          # `endpoint` only for these events.
+          events:,
+          # Signing secret generated by ImageKit, used to verify that webhook requests come
+          # from ImageKit. Starts with `whsec_`. This value can't be set or changed through
+          # the API. Learn more about
+          # [verifying webhook signatures](https://imagekit.io/docs/webhooks#verify-webhook-signature).
+          secret:,
+          # ISO 8601 timestamp of when the webhook was last updated.
+          updated_at:
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              id: String,
+              created_at: Time,
+              enabled: T::Boolean,
+              endpoint: String,
+              events:
+                T::Array[Imagekitio::Accounts::WebhookEventType::TaggedSymbol],
+              secret: String,
+              updated_at: Time
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end