imagekitio 4.10.0 → 4.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3c30ed9b6589210d2b0d5c5cac947cdc09a678c5974b4751287991c9c17c3078
-  data.tar.gz: 49416c6585634a0925a298524cf57ec20043c2acd42b37b8de792a70f4d1f2b4
+  metadata.gz: 235dad9025731b1abd4a01b1d3efd3359f61e4108a3eb4f389c95f90e3756401
+  data.tar.gz: 35f226746a88d656660eee6d93fe41e007e4dc9b078a41f45b4af0c0ac8527ee
 SHA512:
-  metadata.gz: 2b7ffb1d472b479d128ae5eab7983c7ebdf24e7197dcaa7fa8a95c6015069fe08472b3f7e8378ae8071d442d66bd34884504a7c6388ec00facc9f4ef39b879cf
-  data.tar.gz: 889a5b70b8537fef0a4cce92d97be64c7467bcb58d1d9c35b8d03bb337a756423d207a1a70ae112cca591c007ce55bee1730c2704c21ba31e55c3c6b8802fa31
+  metadata.gz: a59934db8998eb5823c08f1857e02a4b73e80ff8cbdd4e465f35bb1774c205b91876214a7bc8614a8d58955775532e65052b4bfbf414a560d4a51edd9acac6d4
+  data.tar.gz: dec48b91ace1963e2a5a3a7bed4908286f225bf35804de1863bea9075bd21bba6a8428fb82cead9101c6b9356dfe58e9e1ef09c1fcc6f4590674ba32804d8242

data/CHANGELOG.md

@@ -1,5 +1,28 @@
 # Changelog
 
+## [4.11.0](https://github.com/imagekit-developer/imagekit-ruby/compare/v4.10.0...v4.11.0) (2026-10-19)
+
+
+### Features
+
+* webhook crud api ([a3fb0a0](https://github.com/imagekit-developer/imagekit-ruby/commit/a3fb0a0e157c5b9d815b54a5e7adf2f3c9b5b8b5))
+
+
+### Bug Fixes
+
+* don't parse empty 204 responses for copy, move and delete methods ([0e04d20](https://github.com/imagekit-developer/imagekit-ruby/commit/0e04d2029befbcd689b7c01699c6675cc1c93af8))
+* **openapi:** reference shared CustomMetadata schema from FolderDetail ([56c04d2](https://github.com/imagekit-developer/imagekit-ruby/commit/56c04d2f29703ed1cf613f097162622ec34dd37b))
+
+
+### Chores
+
+* pin next release ([68b9912](https://github.com/imagekit-developer/imagekit-ruby/commit/68b9912fbf73117ddb2c7966d2100c3a63384573))
+
+
+### Documentation
+
+* describe reserved original creation date field ([b7512b8](https://github.com/imagekit-developer/imagekit-ruby/commit/b7512b8bced102a82f256d674e1eaf2bdf9d1722))
+
 ## [4.10.0](https://github.com/imagekit-developer/imagekit-ruby/compare/v4.9.0...v4.10.0) (2026-09-16)
 
 

data/README.md

@@ -46,7 +46,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "imagekitio", "~> 4.10.0"
+gem "imagekitio", "~> 4.11.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/imagekitio/models/accounts/webhook.rb

@@ -0,0 +1,81 @@
+# frozen_string_literal: true
+
+module Imagekitio
+  module Models
+    module Accounts
+      # @see Imagekitio::Resources::Accounts::Webhooks#create
+      class Webhook < Imagekitio::Internal::Type::BaseModel
+        # @!attribute id
+        #   Unique identifier for a webhook.
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute created_at
+        #   ISO 8601 timestamp of when the webhook was created.
+        #
+        #   @return [Time]
+        required :created_at, Time, api_name: :createdAt
+
+        # @!attribute enabled
+        #   Whether the webhook is enabled. When `false`, ImageKit doesn't send any events
+        #   to the `endpoint`.
+        #
+        #   @return [Boolean]
+        required :enabled, Imagekitio::Internal::Type::Boolean
+
+        # @!attribute endpoint
+        #   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.
+        #
+        #   @return [String]
+        required :endpoint, String
+
+        # @!attribute events
+        #   The event types this webhook is subscribed to. ImageKit sends a request to the
+        #   `endpoint` only for these events.
+        #
+        #   @return [Array<Symbol, Imagekitio::Models::Accounts::WebhookEventType>]
+        required :events, -> { Imagekitio::Internal::Type::ArrayOf[enum: Imagekitio::Accounts::WebhookEventType] }
+
+        # @!attribute secret
+        #   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).
+        #
+        #   @return [String]
+        required :secret, String
+
+        # @!attribute updated_at
+        #   ISO 8601 timestamp of when the webhook was last updated.
+        #
+        #   @return [Time]
+        required :updated_at, Time, api_name: :updatedAt
+
+        # @!method initialize(id:, created_at:, enabled:, endpoint:, events:, secret:, updated_at:)
+        #   Some parameter documentations has been truncated, see
+        #   {Imagekitio::Models::Accounts::Webhook} for more details.
+        #
+        #   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).
+        #
+        #   @param id [String] Unique identifier for a webhook.
+        #
+        #   @param created_at [Time] ISO 8601 timestamp of when the webhook was created.
+        #
+        #   @param enabled [Boolean] Whether the webhook is enabled. When `false`, ImageKit doesn't send any events t
+        #
+        #   @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 secret [String] Signing secret generated by ImageKit, used to verify that webhook requests come
+        #
+        #   @param updated_at [Time] ISO 8601 timestamp of when the webhook was last updated.
+      end
+    end
+  end
+end

data/lib/imagekitio/models/accounts/webhook_create_params.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+module Imagekitio
+  module Models
+    module Accounts
+      # @see Imagekitio::Resources::Accounts::Webhooks#create
+      class WebhookCreateParams < Imagekitio::Internal::Type::BaseModel
+        extend Imagekitio::Internal::Type::RequestParameters::Converter
+        include Imagekitio::Internal::Type::RequestParameters
+
+        # @!attribute endpoint
+        #   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.
+        #
+        #   @return [String]
+        required :endpoint, String
+
+        # @!attribute events
+        #   The event types this webhook is subscribed to. ImageKit sends a request to the
+        #   `endpoint` only for these events.
+        #
+        #   @return [Array<Symbol, Imagekitio::Models::Accounts::WebhookEventType>]
+        required :events, -> { Imagekitio::Internal::Type::ArrayOf[enum: Imagekitio::Accounts::WebhookEventType] }
+
+        # @!attribute enabled
+        #   Whether the webhook is enabled. When `false`, ImageKit doesn't send any events
+        #   to the `endpoint`.
+        #
+        #   @return [Boolean, nil]
+        optional :enabled, Imagekitio::Internal::Type::Boolean
+
+        # @!method initialize(endpoint:, events:, enabled: nil, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Imagekitio::Models::Accounts::WebhookCreateParams} for more details.
+        #
+        #   @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}]
+      end
+    end
+  end
+end

data/lib/imagekitio/models/accounts/webhook_delete_params.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Imagekitio
+  module Models
+    module Accounts
+      # @see Imagekitio::Resources::Accounts::Webhooks#delete
+      class WebhookDeleteParams < Imagekitio::Internal::Type::BaseModel
+        extend Imagekitio::Internal::Type::RequestParameters::Converter
+        include Imagekitio::Internal::Type::RequestParameters
+
+        # @!attribute id
+        #   Unique identifier for a webhook.
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!method initialize(id:, request_options: {})
+        #   @param id [String] Unique identifier for a webhook.
+        #
+        #   @param request_options [Imagekitio::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

data/lib/imagekitio/models/accounts/webhook_event_type.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module Imagekitio
+  module Models
+    module Accounts
+      # A webhook event type. Learn more about the payload of each
+      # [webhook event](https://imagekit.io/docs/webhooks#list-of-events).
+      module WebhookEventType
+        extend Imagekitio::Internal::Type::Enum
+
+        VIDEO_TRANSFORMATION_ACCEPTED = :"video.transformation.accepted"
+        VIDEO_TRANSFORMATION_READY = :"video.transformation.ready"
+        VIDEO_TRANSFORMATION_ERROR = :"video.transformation.error"
+        UPLOAD_PRE_TRANSFORM_SUCCESS = :"upload.pre-transform.success"
+        UPLOAD_PRE_TRANSFORM_ERROR = :"upload.pre-transform.error"
+        UPLOAD_POST_TRANSFORM_SUCCESS = :"upload.post-transform.success"
+        UPLOAD_POST_TRANSFORM_ERROR = :"upload.post-transform.error"
+        FILE_CREATED = :"file.created"
+        FILE_UPDATED = :"file.updated"
+        FILE_DELETED = :"file.deleted"
+        FILE_VERSION_CREATED = :"file-version.created"
+        FILE_VERSION_DELETED = :"file-version.deleted"
+        FOLDER_CREATED = :"folder.created"
+        FOLDER_UPDATED = :"folder.updated"
+        FOLDER_DELETED = :"folder.deleted"
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/imagekitio/models/accounts/webhook_get_params.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Imagekitio
+  module Models
+    module Accounts
+      # @see Imagekitio::Resources::Accounts::Webhooks#get
+      class WebhookGetParams < Imagekitio::Internal::Type::BaseModel
+        extend Imagekitio::Internal::Type::RequestParameters::Converter
+        include Imagekitio::Internal::Type::RequestParameters
+
+        # @!attribute id
+        #   Unique identifier for a webhook.
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!method initialize(id:, request_options: {})
+        #   @param id [String] Unique identifier for a webhook.
+        #
+        #   @param request_options [Imagekitio::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

data/lib/imagekitio/models/accounts/webhook_list_params.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Imagekitio
+  module Models
+    module Accounts
+      # @see Imagekitio::Resources::Accounts::Webhooks#list
+      class WebhookListParams < Imagekitio::Internal::Type::BaseModel
+        extend Imagekitio::Internal::Type::RequestParameters::Converter
+        include Imagekitio::Internal::Type::RequestParameters
+
+        # @!method initialize(request_options: {})
+        #   @param request_options [Imagekitio::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

data/lib/imagekitio/models/accounts/webhook_list_response.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module Imagekitio
+  module Models
+    module Accounts
+      # @type [Imagekitio::Internal::Type::Converter]
+      WebhookListResponse = Imagekitio::Internal::Type::ArrayOf[-> { Imagekitio::Accounts::Webhook }]
+    end
+  end
+end

data/lib/imagekitio/models/accounts/webhook_update_params.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+module Imagekitio
+  module Models
+    module Accounts
+      # @see Imagekitio::Resources::Accounts::Webhooks#update
+      class WebhookUpdateParams < Imagekitio::Internal::Type::BaseModel
+        extend Imagekitio::Internal::Type::RequestParameters::Converter
+        include Imagekitio::Internal::Type::RequestParameters
+
+        # @!attribute id
+        #   Unique identifier for a webhook.
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute enabled
+        #   Whether the webhook is enabled. Omit to leave the current value unchanged.
+        #
+        #   @return [Boolean, nil]
+        optional :enabled, Imagekitio::Internal::Type::Boolean
+
+        # @!attribute endpoint
+        #   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.
+        #
+        #   @return [String, nil]
+        optional :endpoint, String
+
+        # @!attribute events
+        #   The event types this webhook is subscribed to. Replaces the existing list. Omit
+        #   to leave the current value unchanged.
+        #
+        #   @return [Array<Symbol, Imagekitio::Models::Accounts::WebhookEventType>, nil]
+        optional :events, -> { Imagekitio::Internal::Type::ArrayOf[enum: Imagekitio::Accounts::WebhookEventType] }
+
+        # @!method initialize(id:, enabled: nil, endpoint: nil, events: nil, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Imagekitio::Models::Accounts::WebhookUpdateParams} for more details.
+        #
+        #   @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}]
+      end
+    end
+  end
+end

data/lib/imagekitio/models/asset_list_params.rb

@@ -62,6 +62,15 @@ module Imagekitio
       #   Sort the results by one of the supported fields in ascending or descending
       #   order.
       #
+      #   `ASC_ORIGINAL_CREATION_DATE` and `DESC_ORIGINAL_CREATION_DATE` sort files by the
+      #   value of the reserved `_internal_original_created_datetime` custom metadata
+      #   field (labelled "Original creation date" in the dashboard). This field exists
+      #   only after you enable the original creation date setting under the Custom
+      #   Metadata tab of the media library settings. Files that have no value set for
+      #   this field fall back to their upload time, so migrated assets carrying a
+      #   preserved original date and natively uploaded assets are ordered together in a
+      #   single timeline.
+      #
       #   @return [Symbol, Imagekitio::Models::AssetListParams::Sort, nil]
       optional :sort, enum: -> { Imagekitio::AssetListParams::Sort }
 
@@ -114,6 +123,15 @@ module Imagekitio
 
       # Sort the results by one of the supported fields in ascending or descending
       # order.
+      #
+      # `ASC_ORIGINAL_CREATION_DATE` and `DESC_ORIGINAL_CREATION_DATE` sort files by the
+      # value of the reserved `_internal_original_created_datetime` custom metadata
+      # field (labelled "Original creation date" in the dashboard). This field exists
+      # only after you enable the original creation date setting under the Custom
+      # Metadata tab of the media library settings. Files that have no value set for
+      # this field fall back to their upload time, so migrated assets carrying a
+      # preserved original date and natively uploaded assets are ordered together in a
+      # single timeline.
       module Sort
         extend Imagekitio::Internal::Type::Enum
 

data/lib/imagekitio/models/beta/v2/file_upload_params.rb

@@ -132,7 +132,11 @@ module Imagekitio
 
           # @!attribute custom_metadata
           #   JSON key-value pairs to associate with the asset. Create the custom metadata
-          #   fields before setting these values.
+          #   fields before setting these values. 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,

data/lib/imagekitio/models/custom_metadata_field.rb

@@ -40,8 +40,21 @@ module Imagekitio
       optional :description, String
 
       # @!attribute reserved
-      #   Present and set to `true` when the field is reserved. Omitted for regular
-      #   fields. Reserved fields cannot be deleted.
+      #   Present and set to `true` when the field is reserved, i.e. created and managed
+      #   by ImageKit rather than by you. Omitted for regular fields.
+      #
+      #   Currently the only reserved field is `_internal_original_created_datetime`
+      #   (label "Original creation date", type `Date`). ImageKit creates it when you
+      #   enable the original creation date setting under the Custom Metadata tab of the
+      #   media library settings in the dashboard. Use it to preserve the original
+      #   creation date of assets migrated from another system: set its value through the
+      #   `customMetadata` object in the upload or update file details API, then sort with
+      #   `ASC_ORIGINAL_CREATION_DATE` or `DESC_ORIGINAL_CREATION_DATE` in the list and
+      #   search assets API, or filter with
+      #   `"customMetadata._internal_original_created_datetime"` in `searchQuery`.
+      #
+      #   Reserved fields cannot be deleted, and their name cannot be reused when creating
+      #   a new field.
       #
       #   @return [Boolean, nil]
       optional :reserved, Imagekitio::Internal::Type::Boolean
@@ -62,7 +75,7 @@ module Imagekitio
       #
       #   @param description [String] Optional description of the custom metadata field. Only present when a descripti
       #
-      #   @param reserved [Boolean] Present and set to `true` when the field is reserved. Omitted for regular fields
+      #   @param reserved [Boolean] Present and set to `true` when the field is reserved, i.e. created and managed b
 
       # @see Imagekitio::Models::CustomMetadataField#schema
       class Schema < Imagekitio::Internal::Type::BaseModel

data/lib/imagekitio/models/custom_metadata_field_create_params.rb

@@ -20,6 +20,10 @@ module Imagekitio
       #   API name of the custom metadata field. This should be unique across all
       #   (including deleted) custom metadata fields.
       #
+      #   `_internal_original_created_datetime` is a reserved name and cannot be used.
+      #   ImageKit creates that field automatically when you enable the original creation
+      #   date setting in the media library settings.
+      #
       #   @return [String]
       required :name, String
 

data/lib/imagekitio/models/file_upload_params.rb

@@ -130,7 +130,11 @@ module Imagekitio
 
       # @!attribute custom_metadata
       #   JSON key-value pairs to associate with the asset. Create the custom metadata
-      #   fields before setting these values.
+      #   fields before setting these values. 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,

data/lib/imagekitio/models/folder.rb

@@ -10,6 +10,13 @@ module Imagekitio
       #   @return [Time, nil]
       optional :created_at, Time, api_name: :createdAt
 
+      # @!attribute created_by
+      #   Details of the user who created the folder. Present only when this information
+      #   is available. The `name` is the name of the user at the time of folder creation.
+      #
+      #   @return [Imagekitio::Models::Folder::CreatedBy, nil]
+      optional :created_by, -> { Imagekitio::Folder::CreatedBy }, api_name: :createdBy
+
       # @!attribute custom_metadata
       #   An object with custom metadata for the folder. Returns empty object if no custom
       #   metadata is set.
@@ -53,12 +60,14 @@ module Imagekitio
       #   @return [Time, nil]
       optional :updated_at, Time, api_name: :updatedAt
 
-      # @!method initialize(created_at: nil, custom_metadata: nil, folder_id: nil, folder_path: nil, name: nil, type: nil, updated_at: nil)
+      # @!method initialize(created_at: nil, created_by: nil, custom_metadata: nil, folder_id: nil, folder_path: nil, name: nil, type: nil, updated_at: nil)
       #   Some parameter documentations has been truncated, see
       #   {Imagekitio::Models::Folder} for more details.
       #
       #   @param created_at [Time] Date and time when the folder was created. The date and time is in ISO8601 forma
       #
+      #   @param created_by [Imagekitio::Models::Folder::CreatedBy] Details of the user who created the folder. Present only when this information i
+      #
       #   @param custom_metadata [Hash{Symbol=>Object}] An object with custom metadata for the folder. Returns empty object if no custom
       #
       #   @param folder_id [String] Unique identifier of the asset.
@@ -71,6 +80,29 @@ module Imagekitio
       #
       #   @param updated_at [Time] Date and time when the folder was last updated. The date and time is in ISO8601
 
+      # @see Imagekitio::Models::Folder#created_by
+      class CreatedBy < Imagekitio::Internal::Type::BaseModel
+        # @!attribute email
+        #   Email of the user who created the folder.
+        #
+        #   @return [String, nil]
+        optional :email, String
+
+        # @!attribute name
+        #   Name of the user who created the folder.
+        #
+        #   @return [String, nil]
+        optional :name, String
+
+        # @!method initialize(email: nil, name: nil)
+        #   Details of the user who created the folder. Present only when this information
+        #   is available. The `name` is the name of the user at the time of folder creation.
+        #
+        #   @param email [String] Email of the user who created the folder.
+        #
+        #   @param name [String] Name of the user who created the folder.
+      end
+
       # Type of the asset.
       #
       # @see Imagekitio::Models::Folder#type

data/lib/imagekitio/models/folder_create_event.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module Imagekitio
+  module Models
+    class FolderCreateEvent < Imagekitio::Models::BaseWebhookEvent
+      # @!attribute created_at
+      #   Timestamp of when the event occurred in ISO8601 format.
+      #
+      #   @return [Time]
+      required :created_at, Time
+
+      # @!attribute data
+      #
+      #   @return [Imagekitio::Models::Folder]
+      required :data, -> { Imagekitio::Folder }
+
+      # @!attribute type
+      #   Type of the webhook event.
+      #
+      #   @return [Symbol, :"folder.created"]
+      required :type, const: :"folder.created"
+
+      # @!method initialize(created_at:, data:, type: :"folder.created")
+      #   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.
+      #
+      #   @param created_at [Time] Timestamp of when the event occurred in ISO8601 format.
+      #
+      #   @param data [Imagekitio::Models::Folder]
+      #
+      #   @param type [Symbol, :"folder.created"] Type of the webhook event.
+    end
+  end
+end

data/lib/imagekitio/models/folder_delete_event.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+module Imagekitio
+  module Models
+    class FolderDeleteEvent < Imagekitio::Models::BaseWebhookEvent
+      # @!attribute created_at
+      #   Timestamp of when the event occurred in ISO8601 format.
+      #
+      #   @return [Time]
+      required :created_at, Time
+
+      # @!attribute data
+      #
+      #   @return [Imagekitio::Models::FolderDeleteEvent::Data]
+      required :data, -> { Imagekitio::FolderDeleteEvent::Data }
+
+      # @!attribute type
+      #   Type of the webhook event.
+      #
+      #   @return [Symbol, :"folder.deleted"]
+      required :type, const: :"folder.deleted"
+
+      # @!method initialize(created_at:, data:, type: :"folder.deleted")
+      #   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.
+      #
+      #   @param created_at [Time] Timestamp of when the event occurred in ISO8601 format.
+      #
+      #   @param data [Imagekitio::Models::FolderDeleteEvent::Data]
+      #
+      #   @param type [Symbol, :"folder.deleted"] Type of the webhook event.
+
+      class Data < Imagekitio::Internal::Type::BaseModel
+        # @!attribute folder_id
+        #   The unique `folderId` of the deleted folder.
+        #
+        #   @return [String]
+        required :folder_id, String, api_name: :folderId
+
+        # @!method initialize(folder_id:)
+        #   @param folder_id [String] The unique `folderId` of the deleted folder.
+      end
+    end
+  end
+end

data/lib/imagekitio/models/folder_update_event.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module Imagekitio
+  module Models
+    class FolderUpdateEvent < Imagekitio::Models::BaseWebhookEvent
+      # @!attribute created_at
+      #   Timestamp of when the event occurred in ISO8601 format.
+      #
+      #   @return [Time]
+      required :created_at, Time
+
+      # @!attribute data
+      #
+      #   @return [Imagekitio::Models::Folder]
+      required :data, -> { Imagekitio::Folder }
+
+      # @!attribute type
+      #   Type of the webhook event.
+      #
+      #   @return [Symbol, :"folder.updated"]
+      required :type, const: :"folder.updated"
+
+      # @!method initialize(created_at:, data:, type: :"folder.updated")
+      #   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`.
+      #
+      #   @param created_at [Time] Timestamp of when the event occurred in ISO8601 format.
+      #
+      #   @param data [Imagekitio::Models::Folder]
+      #
+      #   @param type [Symbol, :"folder.updated"] Type of the webhook event.
+    end
+  end
+end

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