safetykit 0.57.0 → 0.59.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e4a9fe4f557160546a74ced889958cc6d4661d93568c6661b7af9c58e2fdae86
-  data.tar.gz: '039d13c3701ca7716133699eed8054fe85c58b18dadf80011ddcde34c4698fd0'
+  metadata.gz: 5cd8382bd07b22eba07c2a3db9f9a9cd0c30e5644842b3c47e8f1b1954fa0cba
+  data.tar.gz: bb032a524f14bce495197601991f86b2005a3d93f9bc8da789f0ea35a44556a2
 SHA512:
-  metadata.gz: 98ec2e2670762a62dd4577d7fd3b4f1e00c2f336411690a193f201b9f072a3315d5af4156c2942601d8cbac69621fa0b22480ba996ec1155d8910892c38da4da
-  data.tar.gz: ab2f31b01990b336f95ba3c3b8664c945c15c87aef7e5cb94b22a774c67825098409a7fd4fb2786561e49af435d13ce3162d7724e3ce51017e826e2a97e8d37a
+  metadata.gz: 8e9f79189873e0b34f05815bf85ccfc038016c061e4956163ac9062255b51bcc8050745bcb336a6fa28c69dfb7d6d9a12b9925550523e00890f600c91257ae61
+  data.tar.gz: d8d90a4ae6535c35f3fc26865918d34a23bbdf03a169aac8fff19c6ebfc56a54f1ea6c06be5aef382a6cfb63bdd6bc340db22154e39caa390d6652613992e269

data/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 0.59.0 (2026-08-12)
+
+Full Changelog: [v0.58.0...v0.59.0](https://github.com/GetSafetyKit/safetykit-ruby/compare/v0.58.0...v0.59.0)
+
+### Features
+
+* **api:** api update ([79f835f](https://github.com/GetSafetyKit/safetykit-ruby/commit/79f835fe421b21ca05a77ab77bfeef64aea99285))
+
+## 0.58.0 (2026-08-11)
+
+Full Changelog: [v0.57.0...v0.58.0](https://github.com/GetSafetyKit/safetykit-ruby/compare/v0.57.0...v0.58.0)
+
+### Features
+
+* **api:** api update ([6e357b2](https://github.com/GetSafetyKit/safetykit-ruby/commit/6e357b2845a8f97084b348cb2bf7dccdb97c5d43))
+
 ## 0.57.0 (2026-08-11)
 
 Full Changelog: [v0.56.0...v0.57.0](https://github.com/GetSafetyKit/safetykit-ruby/compare/v0.56.0...v0.57.0)

data/README.md

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

data/lib/safety_kit/models/content_create_params.rb

@@ -7,6 +7,13 @@ module SafetyKit
       extend SafetyKit::Internal::Type::RequestParameters::Converter
       include SafetyKit::Internal::Type::RequestParameters
 
+      # @!attribute content
+      #   Content parts to classify together. At most 20 images.
+      #
+      #   @return [Array<SafetyKit::Models::ContentCreateParams::Content::UnionMember0, SafetyKit::Models::ContentCreateParams::Content::UnionMember1>]
+      required :content,
+               -> { SafetyKit::Internal::Type::ArrayOf[union: SafetyKit::ContentCreateParams::Content] }
+
       # @!attribute user_id
       #   Your stable identifier for the user this content belongs to.
       #
@@ -19,40 +26,152 @@ module SafetyKit
       #   @return [String, nil]
       optional :content_id, String
 
-      # @!attribute images
-      #   Images to classify, each as base64-encoded image bytes, raw or as a data URI. At
-      #   most 5MB each.
-      #
-      #   @return [Array<String>, nil]
-      optional :images, SafetyKit::Internal::Type::ArrayOf[String]
-
       # @!attribute metadata
       #   Additional product context for this content. At most 8KB when serialized.
       #
       #   @return [Hash{Symbol=>Object, nil}, nil]
       optional :metadata, SafetyKit::Internal::Type::HashOf[SafetyKit::Internal::Type::Unknown, nil?: true]
 
-      # @!attribute text
-      #   User-authored text to classify.
+      # @!attribute safety_kit_version
+      #   The API version this operation is defined against.
       #
-      #   @return [String, nil]
-      optional :text, String
+      #   @return [Symbol, SafetyKit::Models::ContentCreateParams::SafetyKitVersion, nil]
+      optional :safety_kit_version, enum: -> { SafetyKit::ContentCreateParams::SafetyKitVersion }
 
-      # @!method initialize(user_id:, content_id: nil, images: nil, metadata: nil, text: nil, request_options: {})
-      #   Some parameter documentations has been truncated, see
-      #   {SafetyKit::Models::ContentCreateParams} for more details.
+      # @!method initialize(content:, user_id:, content_id: nil, metadata: nil, safety_kit_version: nil, request_options: {})
+      #   @param content [Array<SafetyKit::Models::ContentCreateParams::Content::UnionMember0, SafetyKit::Models::ContentCreateParams::Content::UnionMember1>] Content parts to classify together. At most 20 images.
       #
       #   @param user_id [String] Your stable identifier for the user this content belongs to.
       #
       #   @param content_id [String] Your content identifier.
       #
-      #   @param images [Array<String>] Images to classify, each as base64-encoded image bytes, raw or as a data URI. At
-      #
       #   @param metadata [Hash{Symbol=>Object, nil}] Additional product context for this content. At most 8KB when serialized.
       #
-      #   @param text [String] User-authored text to classify.
+      #   @param safety_kit_version [Symbol, SafetyKit::Models::ContentCreateParams::SafetyKitVersion] The API version this operation is defined against.
       #
       #   @param request_options [SafetyKit::RequestOptions, Hash{Symbol=>Object}]
+
+      # One part of the submitted content.
+      module Content
+        extend SafetyKit::Internal::Type::Union
+
+        variant -> { SafetyKit::ContentCreateParams::Content::UnionMember0 }
+
+        variant -> { SafetyKit::ContentCreateParams::Content::UnionMember1 }
+
+        class UnionMember0 < SafetyKit::Internal::Type::BaseModel
+          # @!attribute text
+          #   User-authored text to classify.
+          #
+          #   @return [String]
+          required :text, String
+
+          # @!attribute type
+          #
+          #   @return [Symbol, SafetyKit::Models::ContentCreateParams::Content::UnionMember0::Type]
+          required :type, enum: -> { SafetyKit::ContentCreateParams::Content::UnionMember0::Type }
+
+          # @!attribute key
+          #   Your name for where this part came from.
+          #
+          #   @return [String, nil]
+          optional :key, String
+
+          # @!method initialize(text:, type:, key: nil)
+          #   @param text [String] User-authored text to classify.
+          #
+          #   @param type [Symbol, SafetyKit::Models::ContentCreateParams::Content::UnionMember0::Type]
+          #
+          #   @param key [String] Your name for where this part came from.
+
+          # @see SafetyKit::Models::ContentCreateParams::Content::UnionMember0#type
+          module Type
+            extend SafetyKit::Internal::Type::Enum
+
+            TEXT = :text
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
+
+        class UnionMember1 < SafetyKit::Internal::Type::BaseModel
+          # @!attribute source
+          #
+          #   @return [SafetyKit::Models::ContentCreateParams::Content::UnionMember1::Source]
+          required :source, -> { SafetyKit::ContentCreateParams::Content::UnionMember1::Source }
+
+          # @!attribute type
+          #
+          #   @return [Symbol, SafetyKit::Models::ContentCreateParams::Content::UnionMember1::Type]
+          required :type, enum: -> { SafetyKit::ContentCreateParams::Content::UnionMember1::Type }
+
+          # @!attribute key
+          #   Your name for where this part came from.
+          #
+          #   @return [String, nil]
+          optional :key, String
+
+          # @!method initialize(source:, type:, key: nil)
+          #   @param source [SafetyKit::Models::ContentCreateParams::Content::UnionMember1::Source]
+          #
+          #   @param type [Symbol, SafetyKit::Models::ContentCreateParams::Content::UnionMember1::Type]
+          #
+          #   @param key [String] Your name for where this part came from.
+
+          # @see SafetyKit::Models::ContentCreateParams::Content::UnionMember1#source
+          class Source < SafetyKit::Internal::Type::BaseModel
+            # @!attribute data
+            #   Base64-encoded image bytes, raw or as a data URI. At most 5MB.
+            #
+            #   @return [String]
+            required :data, String
+
+            # @!attribute type
+            #
+            #   @return [Symbol, SafetyKit::Models::ContentCreateParams::Content::UnionMember1::Source::Type]
+            required :type, enum: -> { SafetyKit::ContentCreateParams::Content::UnionMember1::Source::Type }
+
+            # @!method initialize(data:, type:)
+            #   @param data [String] Base64-encoded image bytes, raw or as a data URI. At most 5MB.
+            #
+            #   @param type [Symbol, SafetyKit::Models::ContentCreateParams::Content::UnionMember1::Source::Type]
+
+            # @see SafetyKit::Models::ContentCreateParams::Content::UnionMember1::Source#type
+            module Type
+              extend SafetyKit::Internal::Type::Enum
+
+              BASE64 = :base64
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+          end
+
+          # @see SafetyKit::Models::ContentCreateParams::Content::UnionMember1#type
+          module Type
+            extend SafetyKit::Internal::Type::Enum
+
+            IMAGE = :image
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
+
+        # @!method self.variants
+        #   @return [Array(SafetyKit::Models::ContentCreateParams::Content::UnionMember0, SafetyKit::Models::ContentCreateParams::Content::UnionMember1)]
+      end
+
+      # The API version this operation is defined against.
+      module SafetyKitVersion
+        extend SafetyKit::Internal::Type::Enum
+
+        SAFETY_KIT_VERSION_2026_08_11 = :"2026-08-11"
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
     end
   end
 end

data/lib/safety_kit/models/content_create_response.rb

@@ -10,19 +10,12 @@ module SafetyKit
       #   @return [String]
       required :content_id, String
 
-      # @!attribute policies
-      #   Per-policy results for the submitted content.
+      # @!attribute labels
+      #   Per-label results for the submitted content.
       #
-      #   @return [Array<SafetyKit::Models::ContentCreateResponse::Policy>]
-      required :policies,
-               -> { SafetyKit::Internal::Type::ArrayOf[SafetyKit::Models::ContentCreateResponse::Policy] }
-
-      # @!attribute reference_set_matches
-      #   Reference set matches found for the submitted content.
-      #
-      #   @return [Array<SafetyKit::Models::ContentCreateResponse::ReferenceSetMatch>]
-      required :reference_set_matches,
-               -> { SafetyKit::Internal::Type::ArrayOf[SafetyKit::Models::ContentCreateResponse::ReferenceSetMatch] }
+      #   @return [Array<SafetyKit::Models::ContentCreateResponse::Label::UnionMember0, SafetyKit::Models::ContentCreateResponse::Label::UnionMember1>]
+      required :labels,
+               -> { SafetyKit::Internal::Type::ArrayOf[union: SafetyKit::Models::ContentCreateResponse::Label] }
 
       # @!attribute user_id
       #   The user_id from the request.
@@ -30,113 +23,217 @@ module SafetyKit
       #   @return [String]
       required :user_id, String
 
-      # @!method initialize(content_id:, policies:, reference_set_matches:, user_id:)
+      # @!attribute version
+      #   The API version that served this request.
+      #
+      #   @return [String]
+      required :version, String
+
+      # @!method initialize(content_id:, labels:, user_id:, version:)
       #   Synchronous classification result for the submitted content.
       #
       #   @param content_id [String] SafetyKit identifier for the classified content.
       #
-      #   @param policies [Array<SafetyKit::Models::ContentCreateResponse::Policy>] Per-policy results for the submitted content.
-      #
-      #   @param reference_set_matches [Array<SafetyKit::Models::ContentCreateResponse::ReferenceSetMatch>] Reference set matches found for the submitted content.
+      #   @param labels [Array<SafetyKit::Models::ContentCreateResponse::Label::UnionMember0, SafetyKit::Models::ContentCreateResponse::Label::UnionMember1>] Per-label results for the submitted content.
       #
       #   @param user_id [String] The user_id from the request.
-
-      class Policy < SafetyKit::Internal::Type::BaseModel
-        # @!attribute decision
-        #   Whether the submitted content violates the policy.
-        #
-        #   @return [Symbol, SafetyKit::Models::ContentCreateResponse::Policy::Decision]
-        required :decision, enum: -> { SafetyKit::Models::ContentCreateResponse::Policy::Decision }
-
-        # @!attribute escalation
-        #   Escalation outcome for this policy.
-        #
-        #   @return [Symbol, SafetyKit::Models::ContentCreateResponse::Policy::Escalation]
-        required :escalation, enum: -> { SafetyKit::Models::ContentCreateResponse::Policy::Escalation }
-
-        # @!attribute policy_id
-        #   Identifier of the policy.
-        #
-        #   @return [String]
-        required :policy_id, String
-
-        # @!attribute score
-        #   Classifier score between 0 and 1. Higher means more likely violating. Null when
-        #   no classifier scored the policy.
-        #
-        #   @return [Float, nil]
-        required :score, Float, nil?: true
-
-        # @!attribute version
-        #   Version of the policy.
-        #
-        #   @return [String]
-        required :version, String
-
-        # @!method initialize(decision:, escalation:, policy_id:, score:, version:)
-        #   Some parameter documentations has been truncated, see
-        #   {SafetyKit::Models::ContentCreateResponse::Policy} for more details.
-        #
-        #   Result for one policy evaluated against the submitted content.
-        #
-        #   @param decision [Symbol, SafetyKit::Models::ContentCreateResponse::Policy::Decision] Whether the submitted content violates the policy.
-        #
-        #   @param escalation [Symbol, SafetyKit::Models::ContentCreateResponse::Policy::Escalation] Escalation outcome for this policy.
-        #
-        #   @param policy_id [String] Identifier of the policy.
-        #
-        #   @param score [Float, nil] Classifier score between 0 and 1. Higher means more likely violating. Null when
-        #
-        #   @param version [String] Version of the policy.
-
-        # Whether the submitted content violates the policy.
-        #
-        # @see SafetyKit::Models::ContentCreateResponse::Policy#decision
-        module Decision
-          extend SafetyKit::Internal::Type::Enum
-
-          MATCH = :match
-          NOT_MATCH = :not_match
-          REVIEW = :review
-
-          # @!method self.values
-          #   @return [Array<Symbol>]
+      #
+      #   @param version [String] The API version that served this request.
+
+      # Result for one label evaluated against the submitted content.
+      module Label
+        extend SafetyKit::Internal::Type::Union
+
+        variant -> { SafetyKit::Models::ContentCreateResponse::Label::UnionMember0 }
+
+        variant -> { SafetyKit::Models::ContentCreateResponse::Label::UnionMember1 }
+
+        class UnionMember0 < SafetyKit::Internal::Type::BaseModel
+          # @!attribute decision
+          #   Whether the submitted content matches the label.
+          #
+          #   @return [Symbol, SafetyKit::Models::ContentCreateResponse::Label::UnionMember0::Decision]
+          required :decision, enum: -> { SafetyKit::Models::ContentCreateResponse::Label::UnionMember0::Decision }
+
+          # @!attribute escalation
+          #   Escalation outcome for this label.
+          #
+          #   @return [Symbol, SafetyKit::Models::ContentCreateResponse::Label::UnionMember0::Escalation]
+          required :escalation,
+                   enum: -> { SafetyKit::Models::ContentCreateResponse::Label::UnionMember0::Escalation }
+
+          # @!attribute label
+          #   Label identifier.
+          #
+          #   @return [String]
+          required :label, String
+
+          # @!attribute score
+          #   Classifier score between 0 and 1. Higher means more likely matching. Null when
+          #   no classifier scored the label.
+          #
+          #   @return [Float, nil]
+          required :score, Float, nil?: true
+
+          # @!attribute type
+          #
+          #   @return [Symbol, SafetyKit::Models::ContentCreateResponse::Label::UnionMember0::Type]
+          required :type, enum: -> { SafetyKit::Models::ContentCreateResponse::Label::UnionMember0::Type }
+
+          # @!method initialize(decision:, escalation:, label:, score:, type:)
+          #   Some parameter documentations has been truncated, see
+          #   {SafetyKit::Models::ContentCreateResponse::Label::UnionMember0} for more
+          #   details.
+          #
+          #   @param decision [Symbol, SafetyKit::Models::ContentCreateResponse::Label::UnionMember0::Decision] Whether the submitted content matches the label.
+          #
+          #   @param escalation [Symbol, SafetyKit::Models::ContentCreateResponse::Label::UnionMember0::Escalation] Escalation outcome for this label.
+          #
+          #   @param label [String] Label identifier.
+          #
+          #   @param score [Float, nil] Classifier score between 0 and 1. Higher means more likely matching. Null when n
+          #
+          #   @param type [Symbol, SafetyKit::Models::ContentCreateResponse::Label::UnionMember0::Type]
+
+          # Whether the submitted content matches the label.
+          #
+          # @see SafetyKit::Models::ContentCreateResponse::Label::UnionMember0#decision
+          module Decision
+            extend SafetyKit::Internal::Type::Enum
+
+            MATCH = :match
+            NOT_MATCH = :not_match
+            REVIEW = :review
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          # Escalation outcome for this label.
+          #
+          # @see SafetyKit::Models::ContentCreateResponse::Label::UnionMember0#escalation
+          module Escalation
+            extend SafetyKit::Internal::Type::Enum
+
+            NONE = :none
+            COMPLETED = :completed
+            ERROR = :error
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          # @see SafetyKit::Models::ContentCreateResponse::Label::UnionMember0#type
+          module Type
+            extend SafetyKit::Internal::Type::Enum
+
+            CLASSIFIER = :classifier
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
         end
 
-        # Escalation outcome for this policy.
-        #
-        # @see SafetyKit::Models::ContentCreateResponse::Policy#escalation
-        module Escalation
-          extend SafetyKit::Internal::Type::Enum
-
-          NONE = :none
-          COMPLETED = :completed
-          ERROR = :error
-
-          # @!method self.values
-          #   @return [Array<Symbol>]
+        class UnionMember1 < SafetyKit::Internal::Type::BaseModel
+          # @!attribute decision
+          #   Whether the submitted content matches the label.
+          #
+          #   @return [Symbol, SafetyKit::Models::ContentCreateResponse::Label::UnionMember1::Decision]
+          required :decision, enum: -> { SafetyKit::Models::ContentCreateResponse::Label::UnionMember1::Decision }
+
+          # @!attribute escalation
+          #   Escalation outcome for this label.
+          #
+          #   @return [Symbol, SafetyKit::Models::ContentCreateResponse::Label::UnionMember1::Escalation]
+          required :escalation,
+                   enum: -> { SafetyKit::Models::ContentCreateResponse::Label::UnionMember1::Escalation }
+
+          # @!attribute label
+          #
+          #   @return [Symbol, SafetyKit::Models::ContentCreateResponse::Label::UnionMember1::Label]
+          required :label, enum: -> { SafetyKit::Models::ContentCreateResponse::Label::UnionMember1::Label }
+
+          # @!attribute score
+          #   Similarity between the submitted content and the matched entry.
+          #
+          #   @return [Float]
+          required :score, Float
+
+          # @!attribute set_id
+          #   Identifier of the matched reference set.
+          #
+          #   @return [String]
+          required :set_id, String
+
+          # @!attribute type
+          #
+          #   @return [Symbol, SafetyKit::Models::ContentCreateResponse::Label::UnionMember1::Type]
+          required :type, enum: -> { SafetyKit::Models::ContentCreateResponse::Label::UnionMember1::Type }
+
+          # @!method initialize(decision:, escalation:, label:, score:, set_id:, type:)
+          #   @param decision [Symbol, SafetyKit::Models::ContentCreateResponse::Label::UnionMember1::Decision] Whether the submitted content matches the label.
+          #
+          #   @param escalation [Symbol, SafetyKit::Models::ContentCreateResponse::Label::UnionMember1::Escalation] Escalation outcome for this label.
+          #
+          #   @param label [Symbol, SafetyKit::Models::ContentCreateResponse::Label::UnionMember1::Label]
+          #
+          #   @param score [Float] Similarity between the submitted content and the matched entry.
+          #
+          #   @param set_id [String] Identifier of the matched reference set.
+          #
+          #   @param type [Symbol, SafetyKit::Models::ContentCreateResponse::Label::UnionMember1::Type]
+
+          # Whether the submitted content matches the label.
+          #
+          # @see SafetyKit::Models::ContentCreateResponse::Label::UnionMember1#decision
+          module Decision
+            extend SafetyKit::Internal::Type::Enum
+
+            MATCH = :match
+            NOT_MATCH = :not_match
+            REVIEW = :review
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          # Escalation outcome for this label.
+          #
+          # @see SafetyKit::Models::ContentCreateResponse::Label::UnionMember1#escalation
+          module Escalation
+            extend SafetyKit::Internal::Type::Enum
+
+            NONE = :none
+            COMPLETED = :completed
+            ERROR = :error
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          # @see SafetyKit::Models::ContentCreateResponse::Label::UnionMember1#label
+          module Label
+            extend SafetyKit::Internal::Type::Enum
+
+            REFERENCE_SET_MATCH = :reference_set_match
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          # @see SafetyKit::Models::ContentCreateResponse::Label::UnionMember1#type
+          module Type
+            extend SafetyKit::Internal::Type::Enum
+
+            SIMILARITY = :similarity
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
         end
-      end
 
-      class ReferenceSetMatch < SafetyKit::Internal::Type::BaseModel
-        # @!attribute set_id
-        #   Identifier of the matched reference set.
-        #
-        #   @return [String]
-        required :set_id, String
-
-        # @!attribute similarity
-        #   Similarity between the submitted content and the matched reference set entry.
-        #
-        #   @return [Float]
-        required :similarity, Float
-
-        # @!method initialize(set_id:, similarity:)
-        #   Reference set match found for the submitted content.
-        #
-        #   @param set_id [String] Identifier of the matched reference set.
-        #
-        #   @param similarity [Float] Similarity between the submitted content and the matched reference set entry.
+        # @!method self.variants
+        #   @return [Array(SafetyKit::Models::ContentCreateResponse::Label::UnionMember0, SafetyKit::Models::ContentCreateResponse::Label::UnionMember1)]
       end
     end
   end

data/lib/safety_kit/models/data_update_settings_params.rb

@@ -14,10 +14,8 @@ module SafetyKit
       required :namespace, String
 
       # @!attribute schema
-      #   Schema mapping field names to their definitions. Use content_type to specify
-      #   which fields contain URLs that should be processed (images, videos, or
-      #   websites), datetime fields, or 'metadata' for fields that should be stored but
-      #   not indexed. Use display_hint to provide UI rendering hints.
+      #   New schema to store for this namespace. Omit to leave the existing schema
+      #   unchanged.
       #
       #   @return [Hash{Symbol=>SafetyKit::Models::DataUpdateSettingsParams::Schema}, nil]
       optional :schema, -> { SafetyKit::Internal::Type::HashOf[SafetyKit::DataUpdateSettingsParams::Schema] }
@@ -35,7 +33,7 @@ module SafetyKit
       #
       #   @param namespace [String] The namespace to ingest data into
       #
-      #   @param schema [Hash{Symbol=>SafetyKit::Models::DataUpdateSettingsParams::Schema}] Schema mapping field names to their definitions. Use content_type to specify whi
+      #   @param schema [Hash{Symbol=>SafetyKit::Models::DataUpdateSettingsParams::Schema}] New schema to store for this namespace. Omit to leave the existing schema unchan
       #
       #   @param settings [Hash{Symbol=>Object, nil}] Namespace settings to store, replacing existing settings. Omit to leave existing
       #
@@ -59,7 +57,7 @@ module SafetyKit
         optional :content_type, enum: -> { SafetyKit::DataUpdateSettingsParams::Schema::ContentType }
 
         # @!attribute display_hint
-        #   Display hint for UI rendering of this field
+        #   Optional hint for how this field should be displayed in the UI
         #
         #   @return [SafetyKit::Models::DataUpdateSettingsParams::Schema::DisplayHint, nil]
         optional :display_hint, -> { SafetyKit::DataUpdateSettingsParams::Schema::DisplayHint }
@@ -88,7 +86,7 @@ module SafetyKit
         #
         #   @param content_type [Symbol, SafetyKit::Models::DataUpdateSettingsParams::Schema::ContentType] The type of content (image_url, video_url, audio_url, website_url, datetime, met
         #
-        #   @param display_hint [SafetyKit::Models::DataUpdateSettingsParams::Schema::DisplayHint] Display hint for UI rendering of this field
+        #   @param display_hint [SafetyKit::Models::DataUpdateSettingsParams::Schema::DisplayHint] Optional hint for how this field should be displayed in the UI
         #
         #   @param field_limit [Integer] Maximum amount of this field to include when sending to AI models. For text fiel
         #
@@ -137,7 +135,7 @@ module SafetyKit
           optional :type, enum: -> { SafetyKit::DataUpdateSettingsParams::Schema::DisplayHint::Type }
 
           # @!method initialize(hidden: nil, name: nil, type: nil)
-          #   Display hint for UI rendering of this field
+          #   Optional hint for how this field should be displayed in the UI
           #
           #   @param hidden [Boolean] Hide this field from default UI display.
           #