imagekitio 4.2.0 → 4.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1b92857709e6bb0bab7799b7475cc8bfba73a93b0f51b04d7e9bfcf63d4818ec
-  data.tar.gz: 4383584d3b958367e7ac4378bd36bba819aac8eb67a74c1ec21f123d1f9a2e39
+  metadata.gz: 3281ae61effcaaded900c340f50f3d969c218f51db36e3a1bbf1ecf0698e4859
+  data.tar.gz: 8c6a57f45cacfa242f22efe0f7ef59fa74a433c273301545d9f2d1741fc9d3ee
 SHA512:
-  metadata.gz: 3c0c0bfabf94611155871a5f4a33086c7943ee492e6ac4d9a93afe805ac9ea8463edd6e6d0098dc5662295775a428e30ffedd50b3b217838eea2de94412c7d1b
-  data.tar.gz: f6d394f0889d212baa8f160cc5676ef25fdf212d4c2fac50b321bb597c110585fdec997952fe40f4c5a6b638acf504ee563bddbadd90520e356780b77170ae24
+  metadata.gz: 6b36fc91ac87e5f585f47de86eefbeb123890728fbf6fa983c388e9b3bbfa9976e09c1515a616dba95a937ca2646575a5b253855f28e52999c44f872eee97cbb
+  data.tar.gz: b406ae855b093a5c2d09168e750182fda97b8281ed59295f6245cdc82eda65df2a21f0db07f94affdb272edb16875ff949121eacb159ff1efdd4a2c40440690f

data/CHANGELOG.md

@@ -1,5 +1,43 @@
 # Changelog
 
+## 4.3.0 (2026-04-06)
+
+Full Changelog: [v4.2.0...v4.3.0](https://github.com/imagekit-developer/imagekit-ruby/compare/v4.2.0...v4.3.0)
+
+### Features
+
+* **api:** add support for x_center, y_center, and anchor_point in overlay positioning ([dcbcf76](https://github.com/imagekit-developer/imagekit-ruby/commit/dcbcf7610f2a484689f5c83a8779ab3dd4c5b092))
+* **api:** dpr type update ([650aa0f](https://github.com/imagekit-developer/imagekit-ruby/commit/650aa0f905b4a586c036ae2f019bd7cfb7775d40))
+* **api:** Introduce lxc, lyc, lap parameters in overlays. ([5a87ef0](https://github.com/imagekit-developer/imagekit-ruby/commit/5a87ef064bc9c14d1d62bbd338b64d7718888460))
+* **api:** revert dpr breaking change ([525e6a8](https://github.com/imagekit-developer/imagekit-ruby/commit/525e6a8a59f0f4a17ab17468aebc4b8ccdce182c))
+* **client:** add webhook support ([2a65217](https://github.com/imagekit-developer/imagekit-ruby/commit/2a65217314672d643372aafed4c83adf19c0566f))
+
+
+### Bug Fixes
+
+* align path encoding with RFC 3986 section 3.3 ([88f5590](https://github.com/imagekit-developer/imagekit-ruby/commit/88f5590fc3bb8b7766d4698892aff762f80d3629))
+* **client:** add types for path params, and update structure of unions nested in params ([dd1e1ec](https://github.com/imagekit-developer/imagekit-ruby/commit/dd1e1ec791f563877bc2262b0aea91f4df9b2ced))
+* **client:** always add content-length to post body, even when empty ([e156b70](https://github.com/imagekit-developer/imagekit-ruby/commit/e156b70c82c9b38de49307218fb3f687f651aa5b))
+* **client:** loosen json header parsing ([9fc1fc6](https://github.com/imagekit-developer/imagekit-ruby/commit/9fc1fc60c60173f92f1f99fabe38f9ec826d940d))
+* **client:** serialize query parameters properly ([bbfc6e0](https://github.com/imagekit-developer/imagekit-ruby/commit/bbfc6e0d80da5661600a888e8c915d336919fe36))
+* **internal:** correct multipart form field name encoding ([f3c20a9](https://github.com/imagekit-developer/imagekit-ruby/commit/f3c20a9740682cb96e90eecfd617f204cd28a491))
+* properly mock time in ruby ci tests ([8f0a0a9](https://github.com/imagekit-developer/imagekit-ruby/commit/8f0a0a93ebc66d8d56d5e47950607f8d67f37514))
+* variable name typo ([1d32dc3](https://github.com/imagekit-developer/imagekit-ruby/commit/1d32dc3ec09c80961cc58ecfd40b2449957a2ac9))
+
+
+### Chores
+
+* **ci:** add build step ([c213724](https://github.com/imagekit-developer/imagekit-ruby/commit/c213724d793c735b09c784a5a285cf394f79d528))
+* **ci:** skip lint on metadata-only changes ([62e401f](https://github.com/imagekit-developer/imagekit-ruby/commit/62e401f6fc35fa3bc0e16593bab8e4a477536d4f))
+* **ci:** skip uploading artifacts on stainless-internal branches ([fbc0465](https://github.com/imagekit-developer/imagekit-ruby/commit/fbc0465b3c2fc05da7a61fe74fab19189be90305))
+* **ci:** support opting out of skipping builds on metadata-only commits ([af71b49](https://github.com/imagekit-developer/imagekit-ruby/commit/af71b4919ea7eb3bf704ed6a83eaa9301b5201f9))
+* **docs:** remove www prefix ([a4b9610](https://github.com/imagekit-developer/imagekit-ruby/commit/a4b961058ac8967dcfef109421dbca9ee3eedf0b))
+* **internal:** remove mock server code ([c8aa3b8](https://github.com/imagekit-developer/imagekit-ruby/commit/c8aa3b8c2320102d8e29941f78f1f1ade06cab00))
+* **internal:** tweak CI branches ([125e8b4](https://github.com/imagekit-developer/imagekit-ruby/commit/125e8b4b0f3676378a863bacfc3cc93bf7b3f6ee))
+* **internal:** update gitignore ([741331c](https://github.com/imagekit-developer/imagekit-ruby/commit/741331c210a1af49f43ff77f593293e42882c15b))
+* update mock server docs ([1e5ed9e](https://github.com/imagekit-developer/imagekit-ruby/commit/1e5ed9ea31388b76995c292fc22f9ed773ad6f40))
+* update placeholder string ([cff7f1b](https://github.com/imagekit-developer/imagekit-ruby/commit/cff7f1b4cf7a249e7dd6f426c992472238a8c6e1))
+
 ## 4.2.0 (2026-02-02)
 
 Full Changelog: [v4.1.2...v4.2.0](https://github.com/imagekit-developer/imagekit-ruby/compare/v4.1.2...v4.2.0)

data/README.md

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

data/lib/imagekitio/client.rb

@@ -25,6 +25,13 @@ module Imagekitio
     # @return [String, nil]
     attr_reader :password
 
+    # Your ImageKit webhook secret for verifying webhook signatures (starts with
+    # `whsec_`). You can find this in the
+    # [ImageKit dashboard](https://imagekit.io/dashboard/developer/webhooks). Only
+    # required if you're using webhooks.
+    # @return [String, nil]
+    attr_reader :webhook_secret
+
     # @return [Imagekitio::Resources::CustomMetadataFields]
     attr_reader :custom_metadata_fields
 
@@ -80,6 +87,11 @@ module Imagekitio
     # dummy value. You can ignore this field. Defaults to
     # `ENV["OPTIONAL_IMAGEKIT_IGNORES_THIS"]`
     #
+    # @param webhook_secret [String, nil] Your ImageKit webhook secret for verifying webhook signatures (starts with
+    # `whsec_`). You can find this in the
+    # [ImageKit dashboard](https://imagekit.io/dashboard/developer/webhooks). Only
+    # required if you're using webhooks. Defaults to `ENV["IMAGEKIT_WEBHOOK_SECRET"]`
+    #
     # @param base_url [String, nil] Override the default base URL for the API, e.g.,
     # `"https://api.example.com/v2/"`. Defaults to `ENV["IMAGE_KIT_BASE_URL"]`
     #
@@ -93,6 +105,7 @@ module Imagekitio
     def initialize(
       private_key: ENV["IMAGEKIT_PRIVATE_KEY"],
       password: ENV.fetch("OPTIONAL_IMAGEKIT_IGNORES_THIS", "do_not_set"),
+      webhook_secret: ENV["IMAGEKIT_WEBHOOK_SECRET"],
       base_url: ENV["IMAGE_KIT_BASE_URL"],
       max_retries: self.class::DEFAULT_MAX_RETRIES,
       timeout: self.class::DEFAULT_TIMEOUT_IN_SECONDS,
@@ -109,6 +122,7 @@ module Imagekitio
 
       @private_key = private_key.to_s
       @password = password.to_s
+      @webhook_secret = webhook_secret&.to_s
 
       super(
         base_url: base_url,

data/lib/imagekitio/helpers/helper.rb

@@ -635,11 +635,17 @@ module Imagekitio
       if position
         x = safe_get(position, :x)
         y = safe_get(position, :y_)
+        x_center = safe_get(position, :x_center)
+        y_center = safe_get(position, :y_center)
         focus = safe_get(position, :focus)
+        anchor_point = safe_get(position, :anchor_point)
 
         parts << "lx-#{x}" if x
         parts << "ly-#{y}" if y
+        parts << "lxc-#{x_center}" if x_center
+        parts << "lyc-#{y_center}" if y_center
         parts << "lfo-#{focus}" if focus
+        parts << "lap-#{anchor_point}" if anchor_point
       end
 
       # Add timing properties

data/lib/imagekitio/internal/transport/pooled_net_requester.rb

@@ -75,7 +75,7 @@ module Imagekitio
 
             case body
             in nil
-              nil
+              req["content-length"] ||= 0 unless req["transfer-encoding"]
             in String
               req["content-length"] ||= body.bytesize.to_s unless req["transfer-encoding"]
               req.body_stream = Imagekitio::Internal::Util::ReadIOAdapter.new(body, &blk)

data/lib/imagekitio/internal/util.rb

@@ -157,7 +157,7 @@ module Imagekitio
           in Hash | nil => coerced
             coerced
           else
-            message = "Expected a #{Hash} or #{Imagekitio::Internal::Type::BaseModel}, got #{data.inspect}"
+            message = "Expected a #{Hash} or #{Imagekitio::Internal::Type::BaseModel}, got #{input.inspect}"
             raise ArgumentError.new(message)
           end
         end
@@ -237,6 +237,11 @@ module Imagekitio
         end
       end
 
+      # @type [Regexp]
+      #
+      # https://www.rfc-editor.org/rfc/rfc3986.html#section-3.3
+      RFC_3986_NOT_PCHARS = /[^A-Za-z0-9\-._~!$&'()*+,;=:@]+/
+
       class << self
         # @api private
         #
@@ -247,6 +252,15 @@ module Imagekitio
           "#{uri.scheme}://#{uri.host}#{":#{uri.port}" unless uri.port == uri.default_port}"
         end
 
+        # @api private
+        #
+        # @param path [String, Integer]
+        #
+        # @return [String]
+        def encode_path(path)
+          path.to_s.gsub(Imagekitio::Internal::Util::RFC_3986_NOT_PCHARS) { ERB::Util.url_encode(_1) }
+        end
+
         # @api private
         #
         # @param path [String, Array<String>]
@@ -259,7 +273,7 @@ module Imagekitio
           in []
             ""
           in [String => p, *interpolations]
-            encoded = interpolations.map { ERB::Util.url_encode(_1) }
+            encoded = interpolations.map { encode_path(_1) }
             format(p, *encoded)
           end
         end
@@ -485,11 +499,42 @@ module Imagekitio
       end
 
       # @type [Regexp]
-      JSON_CONTENT = %r{^application/(?:vnd(?:\.[^.]+)*\+)?json(?!l)}
+      JSON_CONTENT = %r{^application/(?:[a-zA-Z0-9.-]+\+)?json(?!l)}
       # @type [Regexp]
       JSONL_CONTENT = %r{^application/(:?x-(?:n|l)djson)|(:?(?:x-)?jsonl)}
 
       class << self
+        # @api private
+        #
+        # @param query [Hash{Symbol=>Object}]
+        #
+        # @return [Hash{Symbol=>Object}]
+        def encode_query_params(query)
+          out = {}
+          query.each { write_query_param_element!(out, _1, _2) }
+          out
+        end
+
+        # @api private
+        #
+        # @param collection [Hash{Symbol=>Object}]
+        # @param key [String]
+        # @param element [Object]
+        #
+        # @return [nil]
+        private def write_query_param_element!(collection, key, element)
+          case element
+          in Hash
+            element.each do |name, value|
+              write_query_param_element!(collection, "#{key}[#{name}]", value)
+            end
+          in Array
+            collection[key] = element.map(&:to_s).join(",")
+          else
+            collection[key] = element.to_s
+          end
+        end
+
         # @api private
         #
         # @param y [Enumerator::Yielder]
@@ -540,16 +585,15 @@ module Imagekitio
           y << "Content-Disposition: form-data"
 
           unless key.nil?
-            name = ERB::Util.url_encode(key.to_s)
-            y << "; name=\"#{name}\""
+            y << "; name=\"#{key}\""
           end
 
           case val
           in Imagekitio::FilePart unless val.filename.nil?
-            filename = ERB::Util.url_encode(val.filename)
+            filename = encode_path(val.filename)
             y << "; filename=\"#{filename}\""
           in Pathname | IO
-            filename = ERB::Util.url_encode(::File.basename(val.to_path))
+            filename = encode_path(::File.basename(val.to_path))
             y << "; filename=\"#{filename}\""
           else
           end

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

@@ -8,15 +8,7 @@ module Imagekitio
         extend Imagekitio::Internal::Type::RequestParameters::Converter
         include Imagekitio::Internal::Type::RequestParameters
 
-        # @!attribute origin_request
-        #   Schema for origin request resources.
-        #
-        #   @return [Imagekitio::Models::Accounts::OriginRequest::S3, Imagekitio::Models::Accounts::OriginRequest::S3Compatible, Imagekitio::Models::Accounts::OriginRequest::CloudinaryBackup, Imagekitio::Models::Accounts::OriginRequest::WebFolder, Imagekitio::Models::Accounts::OriginRequest::WebProxy, Imagekitio::Models::Accounts::OriginRequest::Gcs, Imagekitio::Models::Accounts::OriginRequest::AzureBlob, Imagekitio::Models::Accounts::OriginRequest::AkeneoPim]
-        required :origin_request, union: -> { Imagekitio::Accounts::OriginRequest }
-
-        # @!method initialize(origin_request:, request_options: {})
-        #   @param origin_request [Imagekitio::Models::Accounts::OriginRequest::S3, Imagekitio::Models::Accounts::OriginRequest::S3Compatible, Imagekitio::Models::Accounts::OriginRequest::CloudinaryBackup, Imagekitio::Models::Accounts::OriginRequest::WebFolder, Imagekitio::Models::Accounts::OriginRequest::WebProxy, Imagekitio::Models::Accounts::OriginRequest::Gcs, Imagekitio::Models::Accounts::OriginRequest::AzureBlob, Imagekitio::Models::Accounts::OriginRequest::AkeneoPim] Schema for origin request resources.
-        #
+        # @!method initialize(request_options: {})
         #   @param request_options [Imagekitio::RequestOptions, Hash{Symbol=>Object}]
       end
     end

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

@@ -8,7 +8,19 @@ module Imagekitio
         extend Imagekitio::Internal::Type::RequestParameters::Converter
         include Imagekitio::Internal::Type::RequestParameters
 
-        # @!method initialize(request_options: {})
+        # @!attribute id
+        #   Unique identifier for the origin. This is generated by ImageKit when you create
+        #   a new origin.
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!method initialize(id:, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Imagekitio::Models::Accounts::OriginDeleteParams} for more details.
+        #
+        #   @param id [String] Unique identifier for the origin. This is generated by ImageKit when you create
+        #
         #   @param request_options [Imagekitio::RequestOptions, Hash{Symbol=>Object}]
       end
     end

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

@@ -8,7 +8,19 @@ module Imagekitio
         extend Imagekitio::Internal::Type::RequestParameters::Converter
         include Imagekitio::Internal::Type::RequestParameters
 
-        # @!method initialize(request_options: {})
+        # @!attribute id
+        #   Unique identifier for the origin. This is generated by ImageKit when you create
+        #   a new origin.
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!method initialize(id:, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Imagekitio::Models::Accounts::OriginGetParams} for more details.
+        #
+        #   @param id [String] Unique identifier for the origin. This is generated by ImageKit when you create
+        #
         #   @param request_options [Imagekitio::RequestOptions, Hash{Symbol=>Object}]
       end
     end

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

@@ -8,14 +8,18 @@ module Imagekitio
         extend Imagekitio::Internal::Type::RequestParameters::Converter
         include Imagekitio::Internal::Type::RequestParameters
 
-        # @!attribute origin_request
-        #   Schema for origin request resources.
+        # @!attribute id
+        #   Unique identifier for the origin. This is generated by ImageKit when you create
+        #   a new origin.
         #
-        #   @return [Imagekitio::Models::Accounts::OriginRequest::S3, Imagekitio::Models::Accounts::OriginRequest::S3Compatible, Imagekitio::Models::Accounts::OriginRequest::CloudinaryBackup, Imagekitio::Models::Accounts::OriginRequest::WebFolder, Imagekitio::Models::Accounts::OriginRequest::WebProxy, Imagekitio::Models::Accounts::OriginRequest::Gcs, Imagekitio::Models::Accounts::OriginRequest::AzureBlob, Imagekitio::Models::Accounts::OriginRequest::AkeneoPim]
-        required :origin_request, union: -> { Imagekitio::Accounts::OriginRequest }
+        #   @return [String]
+        required :id, String
 
-        # @!method initialize(origin_request:, request_options: {})
-        #   @param origin_request [Imagekitio::Models::Accounts::OriginRequest::S3, Imagekitio::Models::Accounts::OriginRequest::S3Compatible, Imagekitio::Models::Accounts::OriginRequest::CloudinaryBackup, Imagekitio::Models::Accounts::OriginRequest::WebFolder, Imagekitio::Models::Accounts::OriginRequest::WebProxy, Imagekitio::Models::Accounts::OriginRequest::Gcs, Imagekitio::Models::Accounts::OriginRequest::AzureBlob, Imagekitio::Models::Accounts::OriginRequest::AkeneoPim] Schema for origin request resources.
+        # @!method initialize(id:, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Imagekitio::Models::Accounts::OriginUpdateParams} for more details.
+        #
+        #   @param id [String] Unique identifier for the origin. This is generated by ImageKit when you create
         #
         #   @param request_options [Imagekitio::RequestOptions, Hash{Symbol=>Object}]
       end

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

@@ -8,7 +8,20 @@ module Imagekitio
         extend Imagekitio::Internal::Type::RequestParameters::Converter
         include Imagekitio::Internal::Type::RequestParameters
 
-        # @!method initialize(request_options: {})
+        # @!attribute id
+        #   Unique identifier for the URL-endpoint. This is generated by ImageKit when you
+        #   create a new URL-endpoint. For the default URL-endpoint, this is always
+        #   `default`.
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!method initialize(id:, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Imagekitio::Models::Accounts::URLEndpointDeleteParams} for more details.
+        #
+        #   @param id [String] Unique identifier for the URL-endpoint. This is generated by ImageKit when you c
+        #
         #   @param request_options [Imagekitio::RequestOptions, Hash{Symbol=>Object}]
       end
     end

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

@@ -8,7 +8,20 @@ module Imagekitio
         extend Imagekitio::Internal::Type::RequestParameters::Converter
         include Imagekitio::Internal::Type::RequestParameters
 
-        # @!method initialize(request_options: {})
+        # @!attribute id
+        #   Unique identifier for the URL-endpoint. This is generated by ImageKit when you
+        #   create a new URL-endpoint. For the default URL-endpoint, this is always
+        #   `default`.
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!method initialize(id:, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Imagekitio::Models::Accounts::URLEndpointGetParams} for more details.
+        #
+        #   @param id [String] Unique identifier for the URL-endpoint. This is generated by ImageKit when you c
+        #
         #   @param request_options [Imagekitio::RequestOptions, Hash{Symbol=>Object}]
       end
     end

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

@@ -8,7 +8,20 @@ module Imagekitio
         extend Imagekitio::Internal::Type::RequestParameters::Converter
         include Imagekitio::Internal::Type::RequestParameters
 
-        # @!method initialize(request_options: {})
+        # @!attribute id
+        #   Unique identifier for the URL-endpoint. This is generated by ImageKit when you
+        #   create a new URL-endpoint. For the default URL-endpoint, this is always
+        #   `default`.
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!method initialize(id:, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Imagekitio::Models::Accounts::URLEndpointUpdateParams} for more details.
+        #
+        #   @param id [String] Unique identifier for the URL-endpoint. This is generated by ImageKit when you c
+        #
         #   @param request_options [Imagekitio::RequestOptions, Hash{Symbol=>Object}]
       end
     end

data/lib/imagekitio/models/cache/invalidation_get_params.rb

@@ -8,7 +8,13 @@ module Imagekitio
         extend Imagekitio::Internal::Type::RequestParameters::Converter
         include Imagekitio::Internal::Type::RequestParameters
 
-        # @!method initialize(request_options: {})
+        # @!attribute request_id
+        #
+        #   @return [String]
+        required :request_id, String
+
+        # @!method initialize(request_id:, request_options: {})
+        #   @param request_id [String]
         #   @param request_options [Imagekitio::RequestOptions, Hash{Symbol=>Object}]
       end
     end

data/lib/imagekitio/models/custom_metadata_field_delete_params.rb

@@ -7,7 +7,13 @@ module Imagekitio
       extend Imagekitio::Internal::Type::RequestParameters::Converter
       include Imagekitio::Internal::Type::RequestParameters
 
-      # @!method initialize(request_options: {})
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!method initialize(id:, request_options: {})
+      #   @param id [String]
       #   @param request_options [Imagekitio::RequestOptions, Hash{Symbol=>Object}]
     end
   end

data/lib/imagekitio/models/custom_metadata_field_update_params.rb

@@ -7,6 +7,11 @@ module Imagekitio
       extend Imagekitio::Internal::Type::RequestParameters::Converter
       include Imagekitio::Internal::Type::RequestParameters
 
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
       # @!attribute label
       #   Human readable name of the custom metadata field. This should be unique across
       #   all non deleted custom metadata fields. This name is displayed as form field
@@ -25,10 +30,12 @@ module Imagekitio
       #   @return [Imagekitio::Models::CustomMetadataFieldUpdateParams::Schema, nil]
       optional :schema, -> { Imagekitio::CustomMetadataFieldUpdateParams::Schema }
 
-      # @!method initialize(label: nil, schema: nil, request_options: {})
+      # @!method initialize(id:, label: nil, schema: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {Imagekitio::Models::CustomMetadataFieldUpdateParams} for more details.
       #
+      #   @param id [String]
+      #
       #   @param label [String] Human readable name of the custom metadata field. This should be unique across a
       #
       #   @param schema [Imagekitio::Models::CustomMetadataFieldUpdateParams::Schema] An object that describes the rules for the custom metadata key. This parameter i

data/lib/imagekitio/models/extension_config.rb

@@ -186,8 +186,10 @@ module Imagekitio
             optional :min_selections, Integer
 
             # @!attribute vocabulary
-            #   Array of possible tag values. Combined length of all strings must not exceed 500
-            #   characters. Cannot contain the `%` character.
+            #   Array of possible tag values. The combined length of all strings must not exceed
+            #   500 characters, and values cannot include the `%` character. When providing
+            #   large vocabularies (more than 30 items), the AI may not follow the list
+            #   strictly.
             #
             #   @return [Array<String>, nil]
             optional :vocabulary, Imagekitio::Internal::Type::ArrayOf[String]
@@ -203,7 +205,7 @@ module Imagekitio
             #
             #   @param min_selections [Integer] Minimum number of tags to select from the vocabulary.
             #
-            #   @param vocabulary [Array<String>] Array of possible tag values. Combined length of all strings must not exceed 500
+            #   @param vocabulary [Array<String>] Array of possible tag values. The combined length of all strings must not exceed
             #
             #   @param type [Symbol, :select_tags] Task type that analyzes the image and adds matching tags from a vocabulary.
           end
@@ -241,7 +243,10 @@ module Imagekitio
             optional :min_selections, Integer
 
             # @!attribute vocabulary
-            #   Array of possible values matching the custom metadata field type.
+            #   An array of possible values matching the custom metadata field type. If not
+            #   provided for SingleSelect or MultiSelect field types, all values from the custom
+            #   metadata field definition will be used. When providing large vocabularies (above
+            #   30 items), the AI may not strictly adhere to the list.
             #
             #   @return [Array<String, Float, Boolean>, nil]
             optional :vocabulary,
@@ -260,7 +265,7 @@ module Imagekitio
             #
             #   @param min_selections [Integer] Minimum number of values to select from the vocabulary.
             #
-            #   @param vocabulary [Array<String, Float, Boolean>] Array of possible values matching the custom metadata field type.
+            #   @param vocabulary [Array<String, Float, Boolean>] An array of possible values matching the custom metadata field type. If not prov
             #
             #   @param type [Symbol, :select_metadata] Task type that analyzes the image and sets a custom metadata field value from a
 

data/lib/imagekitio/models/extensions.rb

@@ -186,8 +186,10 @@ module Imagekitio
             optional :min_selections, Integer
 
             # @!attribute vocabulary
-            #   Array of possible tag values. Combined length of all strings must not exceed 500
-            #   characters. Cannot contain the `%` character.
+            #   Array of possible tag values. The combined length of all strings must not exceed
+            #   500 characters, and values cannot include the `%` character. When providing
+            #   large vocabularies (more than 30 items), the AI may not follow the list
+            #   strictly.
             #
             #   @return [Array<String>, nil]
             optional :vocabulary, Imagekitio::Internal::Type::ArrayOf[String]
@@ -202,7 +204,7 @@ module Imagekitio
             #
             #   @param min_selections [Integer] Minimum number of tags to select from the vocabulary.
             #
-            #   @param vocabulary [Array<String>] Array of possible tag values. Combined length of all strings must not exceed 500
+            #   @param vocabulary [Array<String>] Array of possible tag values. The combined length of all strings must not exceed
             #
             #   @param type [Symbol, :select_tags] Task type that analyzes the image and adds matching tags from a vocabulary.
           end
@@ -240,7 +242,10 @@ module Imagekitio
             optional :min_selections, Integer
 
             # @!attribute vocabulary
-            #   Array of possible values matching the custom metadata field type.
+            #   An array of possible values matching the custom metadata field type. If not
+            #   provided for SingleSelect or MultiSelect field types, all values from the custom
+            #   metadata field definition will be used. When providing large vocabularies (above
+            #   30 items), the AI may not strictly adhere to the list.
             #
             #   @return [Array<String, Float, Boolean>, nil]
             optional :vocabulary,
@@ -259,7 +264,7 @@ module Imagekitio
             #
             #   @param min_selections [Integer] Minimum number of values to select from the vocabulary.
             #
-            #   @param vocabulary [Array<String, Float, Boolean>] Array of possible values matching the custom metadata field type.
+            #   @param vocabulary [Array<String, Float, Boolean>] An array of possible values matching the custom metadata field type. If not prov
             #
             #   @param type [Symbol, :select_metadata] Task type that analyzes the image and sets a custom metadata field value from a
 

data/lib/imagekitio/models/file_delete_params.rb

@@ -7,7 +7,13 @@ module Imagekitio
       extend Imagekitio::Internal::Type::RequestParameters::Converter
       include Imagekitio::Internal::Type::RequestParameters
 
-      # @!method initialize(request_options: {})
+      # @!attribute file_id
+      #
+      #   @return [String]
+      required :file_id, String
+
+      # @!method initialize(file_id:, request_options: {})
+      #   @param file_id [String]
       #   @param request_options [Imagekitio::RequestOptions, Hash{Symbol=>Object}]
     end
   end

data/lib/imagekitio/models/file_get_params.rb

@@ -7,7 +7,13 @@ module Imagekitio
       extend Imagekitio::Internal::Type::RequestParameters::Converter
       include Imagekitio::Internal::Type::RequestParameters
 
-      # @!method initialize(request_options: {})
+      # @!attribute file_id
+      #
+      #   @return [String]
+      required :file_id, String
+
+      # @!method initialize(file_id:, request_options: {})
+      #   @param file_id [String]
       #   @param request_options [Imagekitio::RequestOptions, Hash{Symbol=>Object}]
     end
   end

data/lib/imagekitio/models/file_update_params.rb

@@ -7,15 +7,13 @@ module Imagekitio
       extend Imagekitio::Internal::Type::RequestParameters::Converter
       include Imagekitio::Internal::Type::RequestParameters
 
-      # @!attribute update_file_request
-      #   Schema for update file update request.
+      # @!attribute file_id
       #
-      #   @return [Imagekitio::Models::UpdateFileRequest::UpdateFileDetails, Imagekitio::Models::UpdateFileRequest::ChangePublicationStatus]
-      required :update_file_request, union: -> { Imagekitio::UpdateFileRequest }
+      #   @return [String]
+      required :file_id, String
 
-      # @!method initialize(update_file_request:, request_options: {})
-      #   @param update_file_request [Imagekitio::Models::UpdateFileRequest::UpdateFileDetails, Imagekitio::Models::UpdateFileRequest::ChangePublicationStatus] Schema for update file update request.
-      #
+      # @!method initialize(file_id:, request_options: {})
+      #   @param file_id [String]
       #   @param request_options [Imagekitio::RequestOptions, Hash{Symbol=>Object}]
     end
   end

data/lib/imagekitio/models/files/metadata_get_params.rb

@@ -8,7 +8,13 @@ module Imagekitio
         extend Imagekitio::Internal::Type::RequestParameters::Converter
         include Imagekitio::Internal::Type::RequestParameters
 
-        # @!method initialize(request_options: {})
+        # @!attribute file_id
+        #
+        #   @return [String]
+        required :file_id, String
+
+        # @!method initialize(file_id:, request_options: {})
+        #   @param file_id [String]
         #   @param request_options [Imagekitio::RequestOptions, Hash{Symbol=>Object}]
       end
     end

data/lib/imagekitio/models/files/version_delete_params.rb

@@ -13,8 +13,14 @@ module Imagekitio
         #   @return [String]
         required :file_id, String
 
-        # @!method initialize(file_id:, request_options: {})
+        # @!attribute version_id
+        #
+        #   @return [String]
+        required :version_id, String
+
+        # @!method initialize(file_id:, version_id:, request_options: {})
         #   @param file_id [String]
+        #   @param version_id [String]
         #   @param request_options [Imagekitio::RequestOptions, Hash{Symbol=>Object}]
       end
     end