safetykit 0.40.0 → 0.41.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 974c6c63859d8e257e98c8ee22a18f74adabbb4111e4935830ce7e08d057f4e0
-  data.tar.gz: 9ce20e4a121b18257fb18d9a597ab9fbb6ae0e060a8e487309ef0a4c78cdf008
+  metadata.gz: 66201fbaeb030a2b7518147ad2ef659300eb51bb92bd6d16c63b70b5cb428301
+  data.tar.gz: 78229890f0c36346293b5561b14c3c28b6215edd0443bb2c46a3532218fae67b
 SHA512:
-  metadata.gz: 38dabf8af87360cfce8fcd9fb6e0bf68144e92f9649afe6f6c7357c9e2acad331dd629f49215430ea3ed9843bd932e546b8794aaa75ff96153ba73884099508b
-  data.tar.gz: 8c66df936f0b4cdd19999dcbe71ab9c2bf35adb03b94fe4bd59886a2ed3e9408c339c79ca29bd593b982df766de0cbfe8a84f0fc87683d7206c857e3b586bfb3
+  metadata.gz: 168216935f69680e825fdb46afbcb7f79f2e0ae1451e26e9bcb336c075d3ee4b2e9a6b8ee33ce889220a1c8d0d99220c90f6a7c1e35cf75d3aa0ba203c6896bf
+  data.tar.gz: 04f11bd1bbde3e55662bdcd9f8ddeb588f5b7a557eb924f2c3c68aae8ec48ca363c68e512cae6dfafb7d0add16fa91ad2faa970ba39a86b22669b1e7d5e0f6b1

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.41.0 (2026-07-16)
+
+Full Changelog: [v0.40.0...v0.41.0](https://github.com/GetSafetyKit/safetykit-ruby/compare/v0.40.0...v0.41.0)
+
+### Features
+
+* **api:** api update ([cc19fe4](https://github.com/GetSafetyKit/safetykit-ruby/commit/cc19fe4c0084d693c9657bb4e2a6ebc721689abd))
+
 ## 0.40.0 (2026-07-15)
 
 Full Changelog: [v0.39.0...v0.40.0](https://github.com/GetSafetyKit/safetykit-ruby/compare/v0.39.0...v0.40.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.40.0"
+gem "safetykit", "~> 0.41.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/safety_kit/models/data_update_settings_params.rb

@@ -0,0 +1,197 @@
+# frozen_string_literal: true
+
+module SafetyKit
+  module Models
+    # @see SafetyKit::Resources::Data#update_settings
+    class DataUpdateSettingsParams < SafetyKit::Internal::Type::BaseModel
+      extend SafetyKit::Internal::Type::RequestParameters::Converter
+      include SafetyKit::Internal::Type::RequestParameters
+
+      # @!attribute namespace
+      #   The namespace to ingest data into
+      #
+      #   @return [String]
+      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.
+      #
+      #   @return [Hash{Symbol=>SafetyKit::Models::DataUpdateSettingsParams::Schema}, nil]
+      optional :schema, -> { SafetyKit::Internal::Type::HashOf[SafetyKit::DataUpdateSettingsParams::Schema] }
+
+      # @!attribute settings
+      #   Namespace settings to store, replacing existing settings. Omit to leave existing
+      #   settings unchanged. Configure these values with guidance from SafetyKit.
+      #
+      #   @return [Hash{Symbol=>Object, nil}, nil]
+      optional :settings, SafetyKit::Internal::Type::HashOf[SafetyKit::Internal::Type::Unknown, nil?: true]
+
+      # @!method initialize(namespace:, schema: nil, settings: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {SafetyKit::Models::DataUpdateSettingsParams} for more details.
+      #
+      #   @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 settings [Hash{Symbol=>Object, nil}] Namespace settings to store, replacing existing settings. Omit to leave existing
+      #
+      #   @param request_options [SafetyKit::RequestOptions, Hash{Symbol=>Object}]
+
+      class Schema < SafetyKit::Internal::Type::BaseModel
+        # @!attribute belongs_to
+        #   The parent object namespace this field belongs to, creating a parent-child
+        #   relationship with that namespace.
+        #
+        #   @return [String, nil]
+        optional :belongs_to, String
+
+        # @!attribute content_type
+        #   The type of content (image_url, video_url, audio_url, website_url, datetime,
+        #   metadata, or card). When specified as a URL type, SafetyKit will process the
+        #   URL. Use 'metadata' for fields that should be stored but not indexed.
+        #
+        #   @return [Symbol, SafetyKit::Models::DataUpdateSettingsParams::Schema::ContentType, nil]
+        optional :content_type, enum: -> { SafetyKit::DataUpdateSettingsParams::Schema::ContentType }
+
+        # @!attribute display_hint
+        #   Display hint for UI rendering of this field
+        #
+        #   @return [SafetyKit::Models::DataUpdateSettingsParams::Schema::DisplayHint, nil]
+        optional :display_hint, -> { SafetyKit::DataUpdateSettingsParams::Schema::DisplayHint }
+
+        # @!attribute field_limit
+        #   Maximum amount of this field to include when sending to AI models. For text
+        #   fields, this is the character limit. For array fields (e.g. image URLs), this is
+        #   the maximum number of items.
+        #
+        #   @return [Integer, nil]
+        optional :field_limit, Integer
+
+        # @!attribute ingest_as
+        #   Optional parser to apply before indexing this field.
+        #
+        #   @return [Symbol, SafetyKit::Models::DataUpdateSettingsParams::Schema::IngestAs, nil]
+        optional :ingest_as, enum: -> { SafetyKit::DataUpdateSettingsParams::Schema::IngestAs }
+
+        # @!method initialize(belongs_to: nil, content_type: nil, display_hint: nil, field_limit: nil, ingest_as: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {SafetyKit::Models::DataUpdateSettingsParams::Schema} for more details.
+        #
+        #   Schema definition for a data field
+        #
+        #   @param belongs_to [String] The parent object namespace this field belongs to, creating a parent-child relat
+        #
+        #   @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 field_limit [Integer] Maximum amount of this field to include when sending to AI models. For text fiel
+        #
+        #   @param ingest_as [Symbol, SafetyKit::Models::DataUpdateSettingsParams::Schema::IngestAs] Optional parser to apply before indexing this field.
+
+        # The type of content (image_url, video_url, audio_url, website_url, datetime,
+        # metadata, or card). When specified as a URL type, SafetyKit will process the
+        # URL. Use 'metadata' for fields that should be stored but not indexed.
+        #
+        # @see SafetyKit::Models::DataUpdateSettingsParams::Schema#content_type
+        module ContentType
+          extend SafetyKit::Internal::Type::Enum
+
+          IMAGE_URL = :image_url
+          VIDEO_URL = :video_url
+          AUDIO_URL = :audio_url
+          WEBSITE_URL = :website_url
+          DATETIME = :datetime
+          METADATA = :metadata
+          CARD = :card
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
+        # @see SafetyKit::Models::DataUpdateSettingsParams::Schema#display_hint
+        class DisplayHint < SafetyKit::Internal::Type::BaseModel
+          # @!attribute hidden
+          #   Hide this field from default UI display.
+          #
+          #   @return [Boolean, nil]
+          optional :hidden, SafetyKit::Internal::Type::Boolean
+
+          # @!attribute name
+          #   Display label to show for this field in the UI
+          #
+          #   @return [String, nil]
+          optional :name, String
+
+          # @!attribute type
+          #   The display hint type
+          #
+          #   @return [Symbol, SafetyKit::Models::DataUpdateSettingsParams::Schema::DisplayHint::Type, nil]
+          optional :type, enum: -> { SafetyKit::DataUpdateSettingsParams::Schema::DisplayHint::Type }
+
+          # @!method initialize(hidden: nil, name: nil, type: nil)
+          #   Display hint for UI rendering of this field
+          #
+          #   @param hidden [Boolean] Hide this field from default UI display.
+          #
+          #   @param name [String] Display label to show for this field in the UI
+          #
+          #   @param type [Symbol, SafetyKit::Models::DataUpdateSettingsParams::Schema::DisplayHint::Type] The display hint type
+
+          # The display hint type
+          #
+          # @see SafetyKit::Models::DataUpdateSettingsParams::Schema::DisplayHint#type
+          module Type
+            extend SafetyKit::Internal::Type::Enum
+
+            TITLE = :title
+            SUBTITLE = :subtitle
+            CATEGORY = :category
+            IDENTIFIER = :identifier
+            CANONICAL_URL = :canonical_url
+            STATUS = :status
+            PRIMARY_TAG_SET = :primary_tag_set
+            TAG_SET = :tag_set
+            TIMESTAMP = :timestamp
+            RATING = :rating
+            SUMMARY = :summary
+            PROFILE_IMAGE = :profile_image
+            PRIMARY_IMAGE = :primary_image
+            IMAGE_SET = :image_set
+            VIDEO_SET = :video_set
+            AUDIO_SET = :audio_set
+            BODY = :body
+            THREAD = :thread
+            TWO_PERSON_CHAT = :two_person_chat
+            MESSAGE = :message
+            PROFILE = :profile
+            MONEY = :money
+            LOCATION = :location
+            ATTRIBUTE_GROUP = :attribute_group
+            ATTRIBUTE = :attribute
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
+
+        # Optional parser to apply before indexing this field.
+        #
+        # @see SafetyKit::Models::DataUpdateSettingsParams::Schema#ingest_as
+        module IngestAs
+          extend SafetyKit::Internal::Type::Enum
+
+          FLOAT = :float
+          DATETIME = :datetime
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end

data/lib/safety_kit/models/data_update_settings_response.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module SafetyKit
+  module Models
+    # @see SafetyKit::Resources::Data#update_settings
+    class DataUpdateSettingsResponse < SafetyKit::Internal::Type::BaseModel
+      # @!attribute namespace
+      #
+      #   @return [String]
+      required :namespace, String
+
+      # @!attribute status
+      #
+      #   @return [Symbol, SafetyKit::Models::DataUpdateSettingsResponse::Status]
+      required :status, enum: -> { SafetyKit::Models::DataUpdateSettingsResponse::Status }
+
+      # @!method initialize(namespace:, status:)
+      #   Namespace configuration was stored.
+      #
+      #   @param namespace [String]
+      #   @param status [Symbol, SafetyKit::Models::DataUpdateSettingsResponse::Status]
+
+      # @see SafetyKit::Models::DataUpdateSettingsResponse#status
+      module Status
+        extend SafetyKit::Internal::Type::Enum
+
+        UPDATED = :updated
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/safety_kit/models.rb

@@ -57,6 +57,8 @@ module SafetyKit
 
   DataObject = SafetyKit::Models::DataObject
 
+  DataUpdateSettingsParams = SafetyKit::Models::DataUpdateSettingsParams
+
   DeletionRequestCreateParams = SafetyKit::Models::DeletionRequestCreateParams
 
   StreamAddFrameParams = SafetyKit::Models::StreamAddFrameParams

data/lib/safety_kit/resources/data.rb

@@ -113,6 +113,37 @@ module SafetyKit
         )
       end
 
+      # Some parameter documentations has been truncated, see
+      # {SafetyKit::Models::DataUpdateSettingsParams} for more details.
+      #
+      # Update the schema and/or settings for a namespace. Only the fields provided are
+      # updated; omitted fields are left unchanged. Namespaces whose configuration is
+      # managed by SafetyKit cannot be updated through this endpoint.
+      #
+      # @overload update_settings(namespace, schema: nil, settings: nil, request_options: {})
+      #
+      # @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 settings [Hash{Symbol=>Object, nil}] Namespace settings to store, replacing existing settings. Omit to leave existing
+      #
+      # @param request_options [SafetyKit::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [SafetyKit::Models::DataUpdateSettingsResponse]
+      #
+      # @see SafetyKit::Models::DataUpdateSettingsParams
+      def update_settings(namespace, params = {})
+        parsed, options = SafetyKit::DataUpdateSettingsParams.dump_request(params)
+        @client.request(
+          method: :put,
+          path: ["v1/data/%1$s/settings", namespace],
+          body: parsed,
+          model: SafetyKit::Models::DataUpdateSettingsResponse,
+          options: options
+        )
+      end
+
       # @api private
       #
       # @param client [SafetyKit::Client]

data/lib/safety_kit/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module SafetyKit
-  VERSION = "0.40.0"
+  VERSION = "0.41.0"
 end

data/lib/safety_kit.rb

@@ -69,6 +69,8 @@ require_relative "safety_kit/models/data_get_download_url_response"
 require_relative "safety_kit/models/data_get_status_params"
 require_relative "safety_kit/models/data_get_status_response"
 require_relative "safety_kit/models/data_object"
+require_relative "safety_kit/models/data_update_settings_params"
+require_relative "safety_kit/models/data_update_settings_response"
 require_relative "safety_kit/models/deletion_request_create_params"
 require_relative "safety_kit/models/deletion_request_create_response"
 require_relative "safety_kit/models/stream_add_frame_params"

data/rbi/safety_kit/models/data_update_settings_params.rbi

@@ -0,0 +1,543 @@
+# typed: strong
+
+module SafetyKit
+  module Models
+    class DataUpdateSettingsParams < SafetyKit::Internal::Type::BaseModel
+      extend SafetyKit::Internal::Type::RequestParameters::Converter
+      include SafetyKit::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(
+            SafetyKit::DataUpdateSettingsParams,
+            SafetyKit::Internal::AnyHash
+          )
+        end
+
+      # The namespace to ingest data into
+      sig { returns(String) }
+      attr_accessor :namespace
+
+      # 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.
+      sig do
+        returns(
+          T.nilable(
+            T::Hash[Symbol, SafetyKit::DataUpdateSettingsParams::Schema]
+          )
+        )
+      end
+      attr_reader :schema
+
+      sig do
+        params(
+          schema:
+            T::Hash[Symbol, SafetyKit::DataUpdateSettingsParams::Schema::OrHash]
+        ).void
+      end
+      attr_writer :schema
+
+      # Namespace settings to store, replacing existing settings. Omit to leave existing
+      # settings unchanged. Configure these values with guidance from SafetyKit.
+      sig { returns(T.nilable(T::Hash[Symbol, T.nilable(T.anything)])) }
+      attr_reader :settings
+
+      sig { params(settings: T::Hash[Symbol, T.nilable(T.anything)]).void }
+      attr_writer :settings
+
+      sig do
+        params(
+          namespace: String,
+          schema:
+            T::Hash[
+              Symbol,
+              SafetyKit::DataUpdateSettingsParams::Schema::OrHash
+            ],
+          settings: T::Hash[Symbol, T.nilable(T.anything)],
+          request_options: SafetyKit::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # The namespace to ingest data into
+        namespace:,
+        # 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.
+        schema: nil,
+        # Namespace settings to store, replacing existing settings. Omit to leave existing
+        # settings unchanged. Configure these values with guidance from SafetyKit.
+        settings: nil,
+        request_options: {}
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            namespace: String,
+            schema:
+              T::Hash[Symbol, SafetyKit::DataUpdateSettingsParams::Schema],
+            settings: T::Hash[Symbol, T.nilable(T.anything)],
+            request_options: SafetyKit::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+
+      class Schema < SafetyKit::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              SafetyKit::DataUpdateSettingsParams::Schema,
+              SafetyKit::Internal::AnyHash
+            )
+          end
+
+        # The parent object namespace this field belongs to, creating a parent-child
+        # relationship with that namespace.
+        sig { returns(T.nilable(String)) }
+        attr_reader :belongs_to
+
+        sig { params(belongs_to: String).void }
+        attr_writer :belongs_to
+
+        # The type of content (image_url, video_url, audio_url, website_url, datetime,
+        # metadata, or card). When specified as a URL type, SafetyKit will process the
+        # URL. Use 'metadata' for fields that should be stored but not indexed.
+        sig do
+          returns(
+            T.nilable(
+              SafetyKit::DataUpdateSettingsParams::Schema::ContentType::OrSymbol
+            )
+          )
+        end
+        attr_reader :content_type
+
+        sig do
+          params(
+            content_type:
+              SafetyKit::DataUpdateSettingsParams::Schema::ContentType::OrSymbol
+          ).void
+        end
+        attr_writer :content_type
+
+        # Display hint for UI rendering of this field
+        sig do
+          returns(
+            T.nilable(SafetyKit::DataUpdateSettingsParams::Schema::DisplayHint)
+          )
+        end
+        attr_reader :display_hint
+
+        sig do
+          params(
+            display_hint:
+              SafetyKit::DataUpdateSettingsParams::Schema::DisplayHint::OrHash
+          ).void
+        end
+        attr_writer :display_hint
+
+        # Maximum amount of this field to include when sending to AI models. For text
+        # fields, this is the character limit. For array fields (e.g. image URLs), this is
+        # the maximum number of items.
+        sig { returns(T.nilable(Integer)) }
+        attr_reader :field_limit
+
+        sig { params(field_limit: Integer).void }
+        attr_writer :field_limit
+
+        # Optional parser to apply before indexing this field.
+        sig do
+          returns(
+            T.nilable(
+              SafetyKit::DataUpdateSettingsParams::Schema::IngestAs::OrSymbol
+            )
+          )
+        end
+        attr_reader :ingest_as
+
+        sig do
+          params(
+            ingest_as:
+              SafetyKit::DataUpdateSettingsParams::Schema::IngestAs::OrSymbol
+          ).void
+        end
+        attr_writer :ingest_as
+
+        # Schema definition for a data field
+        sig do
+          params(
+            belongs_to: String,
+            content_type:
+              SafetyKit::DataUpdateSettingsParams::Schema::ContentType::OrSymbol,
+            display_hint:
+              SafetyKit::DataUpdateSettingsParams::Schema::DisplayHint::OrHash,
+            field_limit: Integer,
+            ingest_as:
+              SafetyKit::DataUpdateSettingsParams::Schema::IngestAs::OrSymbol
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # The parent object namespace this field belongs to, creating a parent-child
+          # relationship with that namespace.
+          belongs_to: nil,
+          # The type of content (image_url, video_url, audio_url, website_url, datetime,
+          # metadata, or card). When specified as a URL type, SafetyKit will process the
+          # URL. Use 'metadata' for fields that should be stored but not indexed.
+          content_type: nil,
+          # Display hint for UI rendering of this field
+          display_hint: nil,
+          # Maximum amount of this field to include when sending to AI models. For text
+          # fields, this is the character limit. For array fields (e.g. image URLs), this is
+          # the maximum number of items.
+          field_limit: nil,
+          # Optional parser to apply before indexing this field.
+          ingest_as: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              belongs_to: String,
+              content_type:
+                SafetyKit::DataUpdateSettingsParams::Schema::ContentType::OrSymbol,
+              display_hint:
+                SafetyKit::DataUpdateSettingsParams::Schema::DisplayHint,
+              field_limit: Integer,
+              ingest_as:
+                SafetyKit::DataUpdateSettingsParams::Schema::IngestAs::OrSymbol
+            }
+          )
+        end
+        def to_hash
+        end
+
+        # The type of content (image_url, video_url, audio_url, website_url, datetime,
+        # metadata, or card). When specified as a URL type, SafetyKit will process the
+        # URL. Use 'metadata' for fields that should be stored but not indexed.
+        module ContentType
+          extend SafetyKit::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(
+                Symbol,
+                SafetyKit::DataUpdateSettingsParams::Schema::ContentType
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          IMAGE_URL =
+            T.let(
+              :image_url,
+              SafetyKit::DataUpdateSettingsParams::Schema::ContentType::TaggedSymbol
+            )
+          VIDEO_URL =
+            T.let(
+              :video_url,
+              SafetyKit::DataUpdateSettingsParams::Schema::ContentType::TaggedSymbol
+            )
+          AUDIO_URL =
+            T.let(
+              :audio_url,
+              SafetyKit::DataUpdateSettingsParams::Schema::ContentType::TaggedSymbol
+            )
+          WEBSITE_URL =
+            T.let(
+              :website_url,
+              SafetyKit::DataUpdateSettingsParams::Schema::ContentType::TaggedSymbol
+            )
+          DATETIME =
+            T.let(
+              :datetime,
+              SafetyKit::DataUpdateSettingsParams::Schema::ContentType::TaggedSymbol
+            )
+          METADATA =
+            T.let(
+              :metadata,
+              SafetyKit::DataUpdateSettingsParams::Schema::ContentType::TaggedSymbol
+            )
+          CARD =
+            T.let(
+              :card,
+              SafetyKit::DataUpdateSettingsParams::Schema::ContentType::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                SafetyKit::DataUpdateSettingsParams::Schema::ContentType::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+
+        class DisplayHint < SafetyKit::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                SafetyKit::DataUpdateSettingsParams::Schema::DisplayHint,
+                SafetyKit::Internal::AnyHash
+              )
+            end
+
+          # Hide this field from default UI display.
+          sig { returns(T.nilable(T::Boolean)) }
+          attr_reader :hidden
+
+          sig { params(hidden: T::Boolean).void }
+          attr_writer :hidden
+
+          # Display label to show for this field in the UI
+          sig { returns(T.nilable(String)) }
+          attr_reader :name
+
+          sig { params(name: String).void }
+          attr_writer :name
+
+          # The display hint type
+          sig do
+            returns(
+              T.nilable(
+                SafetyKit::DataUpdateSettingsParams::Schema::DisplayHint::Type::OrSymbol
+              )
+            )
+          end
+          attr_reader :type
+
+          sig do
+            params(
+              type:
+                SafetyKit::DataUpdateSettingsParams::Schema::DisplayHint::Type::OrSymbol
+            ).void
+          end
+          attr_writer :type
+
+          # Display hint for UI rendering of this field
+          sig do
+            params(
+              hidden: T::Boolean,
+              name: String,
+              type:
+                SafetyKit::DataUpdateSettingsParams::Schema::DisplayHint::Type::OrSymbol
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # Hide this field from default UI display.
+            hidden: nil,
+            # Display label to show for this field in the UI
+            name: nil,
+            # The display hint type
+            type: nil
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                hidden: T::Boolean,
+                name: String,
+                type:
+                  SafetyKit::DataUpdateSettingsParams::Schema::DisplayHint::Type::OrSymbol
+              }
+            )
+          end
+          def to_hash
+          end
+
+          # The display hint type
+          module Type
+            extend SafetyKit::Internal::Type::Enum
+
+            TaggedSymbol =
+              T.type_alias do
+                T.all(
+                  Symbol,
+                  SafetyKit::DataUpdateSettingsParams::Schema::DisplayHint::Type
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            TITLE =
+              T.let(
+                :title,
+                SafetyKit::DataUpdateSettingsParams::Schema::DisplayHint::Type::TaggedSymbol
+              )
+            SUBTITLE =
+              T.let(
+                :subtitle,
+                SafetyKit::DataUpdateSettingsParams::Schema::DisplayHint::Type::TaggedSymbol
+              )
+            CATEGORY =
+              T.let(
+                :category,
+                SafetyKit::DataUpdateSettingsParams::Schema::DisplayHint::Type::TaggedSymbol
+              )
+            IDENTIFIER =
+              T.let(
+                :identifier,
+                SafetyKit::DataUpdateSettingsParams::Schema::DisplayHint::Type::TaggedSymbol
+              )
+            CANONICAL_URL =
+              T.let(
+                :canonical_url,
+                SafetyKit::DataUpdateSettingsParams::Schema::DisplayHint::Type::TaggedSymbol
+              )
+            STATUS =
+              T.let(
+                :status,
+                SafetyKit::DataUpdateSettingsParams::Schema::DisplayHint::Type::TaggedSymbol
+              )
+            PRIMARY_TAG_SET =
+              T.let(
+                :primary_tag_set,
+                SafetyKit::DataUpdateSettingsParams::Schema::DisplayHint::Type::TaggedSymbol
+              )
+            TAG_SET =
+              T.let(
+                :tag_set,
+                SafetyKit::DataUpdateSettingsParams::Schema::DisplayHint::Type::TaggedSymbol
+              )
+            TIMESTAMP =
+              T.let(
+                :timestamp,
+                SafetyKit::DataUpdateSettingsParams::Schema::DisplayHint::Type::TaggedSymbol
+              )
+            RATING =
+              T.let(
+                :rating,
+                SafetyKit::DataUpdateSettingsParams::Schema::DisplayHint::Type::TaggedSymbol
+              )
+            SUMMARY =
+              T.let(
+                :summary,
+                SafetyKit::DataUpdateSettingsParams::Schema::DisplayHint::Type::TaggedSymbol
+              )
+            PROFILE_IMAGE =
+              T.let(
+                :profile_image,
+                SafetyKit::DataUpdateSettingsParams::Schema::DisplayHint::Type::TaggedSymbol
+              )
+            PRIMARY_IMAGE =
+              T.let(
+                :primary_image,
+                SafetyKit::DataUpdateSettingsParams::Schema::DisplayHint::Type::TaggedSymbol
+              )
+            IMAGE_SET =
+              T.let(
+                :image_set,
+                SafetyKit::DataUpdateSettingsParams::Schema::DisplayHint::Type::TaggedSymbol
+              )
+            VIDEO_SET =
+              T.let(
+                :video_set,
+                SafetyKit::DataUpdateSettingsParams::Schema::DisplayHint::Type::TaggedSymbol
+              )
+            AUDIO_SET =
+              T.let(
+                :audio_set,
+                SafetyKit::DataUpdateSettingsParams::Schema::DisplayHint::Type::TaggedSymbol
+              )
+            BODY =
+              T.let(
+                :body,
+                SafetyKit::DataUpdateSettingsParams::Schema::DisplayHint::Type::TaggedSymbol
+              )
+            THREAD =
+              T.let(
+                :thread,
+                SafetyKit::DataUpdateSettingsParams::Schema::DisplayHint::Type::TaggedSymbol
+              )
+            TWO_PERSON_CHAT =
+              T.let(
+                :two_person_chat,
+                SafetyKit::DataUpdateSettingsParams::Schema::DisplayHint::Type::TaggedSymbol
+              )
+            MESSAGE =
+              T.let(
+                :message,
+                SafetyKit::DataUpdateSettingsParams::Schema::DisplayHint::Type::TaggedSymbol
+              )
+            PROFILE =
+              T.let(
+                :profile,
+                SafetyKit::DataUpdateSettingsParams::Schema::DisplayHint::Type::TaggedSymbol
+              )
+            MONEY =
+              T.let(
+                :money,
+                SafetyKit::DataUpdateSettingsParams::Schema::DisplayHint::Type::TaggedSymbol
+              )
+            LOCATION =
+              T.let(
+                :location,
+                SafetyKit::DataUpdateSettingsParams::Schema::DisplayHint::Type::TaggedSymbol
+              )
+            ATTRIBUTE_GROUP =
+              T.let(
+                :attribute_group,
+                SafetyKit::DataUpdateSettingsParams::Schema::DisplayHint::Type::TaggedSymbol
+              )
+            ATTRIBUTE =
+              T.let(
+                :attribute,
+                SafetyKit::DataUpdateSettingsParams::Schema::DisplayHint::Type::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  SafetyKit::DataUpdateSettingsParams::Schema::DisplayHint::Type::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
+          end
+        end
+
+        # Optional parser to apply before indexing this field.
+        module IngestAs
+          extend SafetyKit::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(
+                Symbol,
+                SafetyKit::DataUpdateSettingsParams::Schema::IngestAs
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          FLOAT =
+            T.let(
+              :float,
+              SafetyKit::DataUpdateSettingsParams::Schema::IngestAs::TaggedSymbol
+            )
+          DATETIME =
+            T.let(
+              :datetime,
+              SafetyKit::DataUpdateSettingsParams::Schema::IngestAs::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                SafetyKit::DataUpdateSettingsParams::Schema::IngestAs::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/safety_kit/models/data_update_settings_response.rbi

@@ -0,0 +1,74 @@
+# typed: strong
+
+module SafetyKit
+  module Models
+    class DataUpdateSettingsResponse < SafetyKit::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            SafetyKit::Models::DataUpdateSettingsResponse,
+            SafetyKit::Internal::AnyHash
+          )
+        end
+
+      sig { returns(String) }
+      attr_accessor :namespace
+
+      sig do
+        returns(
+          SafetyKit::Models::DataUpdateSettingsResponse::Status::TaggedSymbol
+        )
+      end
+      attr_accessor :status
+
+      # Namespace configuration was stored.
+      sig do
+        params(
+          namespace: String,
+          status:
+            SafetyKit::Models::DataUpdateSettingsResponse::Status::OrSymbol
+        ).returns(T.attached_class)
+      end
+      def self.new(namespace:, status:)
+      end
+
+      sig do
+        override.returns(
+          {
+            namespace: String,
+            status:
+              SafetyKit::Models::DataUpdateSettingsResponse::Status::TaggedSymbol
+          }
+        )
+      end
+      def to_hash
+      end
+
+      module Status
+        extend SafetyKit::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, SafetyKit::Models::DataUpdateSettingsResponse::Status)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        UPDATED =
+          T.let(
+            :updated,
+            SafetyKit::Models::DataUpdateSettingsResponse::Status::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              SafetyKit::Models::DataUpdateSettingsResponse::Status::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
+    end
+  end
+end

data/rbi/safety_kit/models.rbi

@@ -21,6 +21,8 @@ module SafetyKit
 
   DataObject = SafetyKit::Models::DataObject
 
+  DataUpdateSettingsParams = SafetyKit::Models::DataUpdateSettingsParams
+
   DeletionRequestCreateParams = SafetyKit::Models::DeletionRequestCreateParams
 
   StreamAddFrameParams = SafetyKit::Models::StreamAddFrameParams

data/rbi/safety_kit/resources/data.rbi

@@ -82,6 +82,36 @@ module SafetyKit
       )
       end
 
+      # Update the schema and/or settings for a namespace. Only the fields provided are
+      # updated; omitted fields are left unchanged. Namespaces whose configuration is
+      # managed by SafetyKit cannot be updated through this endpoint.
+      sig do
+        params(
+          namespace: String,
+          schema:
+            T::Hash[
+              Symbol,
+              SafetyKit::DataUpdateSettingsParams::Schema::OrHash
+            ],
+          settings: T::Hash[Symbol, T.nilable(T.anything)],
+          request_options: SafetyKit::RequestOptions::OrHash
+        ).returns(SafetyKit::Models::DataUpdateSettingsResponse)
+      end
+      def update_settings(
+        # The namespace to ingest data into
+        namespace,
+        # 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.
+        schema: nil,
+        # Namespace settings to store, replacing existing settings. Omit to leave existing
+        # settings unchanged. Configure these values with guidance from SafetyKit.
+        settings: nil,
+        request_options: {}
+      )
+      end
+
       # @api private
       sig { params(client: SafetyKit::Client).returns(T.attached_class) }
       def self.new(client:)

data/sig/safety_kit/models/data_update_settings_params.rbs

@@ -0,0 +1,223 @@
+module SafetyKit
+  module Models
+    type data_update_settings_params =
+      {
+        namespace: String,
+        schema: ::Hash[Symbol, SafetyKit::DataUpdateSettingsParams::Schema],
+        settings: ::Hash[Symbol, top?]
+      }
+      & SafetyKit::Internal::Type::request_parameters
+
+    class DataUpdateSettingsParams < SafetyKit::Internal::Type::BaseModel
+      extend SafetyKit::Internal::Type::RequestParameters::Converter
+      include SafetyKit::Internal::Type::RequestParameters
+
+      attr_accessor namespace: String
+
+      attr_reader schema: ::Hash[Symbol, SafetyKit::DataUpdateSettingsParams::Schema]?
+
+      def schema=: (
+        ::Hash[Symbol, SafetyKit::DataUpdateSettingsParams::Schema]
+      ) -> ::Hash[Symbol, SafetyKit::DataUpdateSettingsParams::Schema]
+
+      attr_reader settings: ::Hash[Symbol, top?]?
+
+      def settings=: (::Hash[Symbol, top?]) -> ::Hash[Symbol, top?]
+
+      def initialize: (
+        namespace: String,
+        ?schema: ::Hash[Symbol, SafetyKit::DataUpdateSettingsParams::Schema],
+        ?settings: ::Hash[Symbol, top?],
+        ?request_options: SafetyKit::request_opts
+      ) -> void
+
+      def to_hash: -> {
+        namespace: String,
+        schema: ::Hash[Symbol, SafetyKit::DataUpdateSettingsParams::Schema],
+        settings: ::Hash[Symbol, top?],
+        request_options: SafetyKit::RequestOptions
+      }
+
+      type schema =
+        {
+          belongs_to: String,
+          content_type: SafetyKit::Models::DataUpdateSettingsParams::Schema::content_type,
+          display_hint: SafetyKit::DataUpdateSettingsParams::Schema::DisplayHint,
+          field_limit: Integer,
+          ingest_as: SafetyKit::Models::DataUpdateSettingsParams::Schema::ingest_as
+        }
+
+      class Schema < SafetyKit::Internal::Type::BaseModel
+        attr_reader belongs_to: String?
+
+        def belongs_to=: (String) -> String
+
+        attr_reader content_type: SafetyKit::Models::DataUpdateSettingsParams::Schema::content_type?
+
+        def content_type=: (
+          SafetyKit::Models::DataUpdateSettingsParams::Schema::content_type
+        ) -> SafetyKit::Models::DataUpdateSettingsParams::Schema::content_type
+
+        attr_reader display_hint: SafetyKit::DataUpdateSettingsParams::Schema::DisplayHint?
+
+        def display_hint=: (
+          SafetyKit::DataUpdateSettingsParams::Schema::DisplayHint
+        ) -> SafetyKit::DataUpdateSettingsParams::Schema::DisplayHint
+
+        attr_reader field_limit: Integer?
+
+        def field_limit=: (Integer) -> Integer
+
+        attr_reader ingest_as: SafetyKit::Models::DataUpdateSettingsParams::Schema::ingest_as?
+
+        def ingest_as=: (
+          SafetyKit::Models::DataUpdateSettingsParams::Schema::ingest_as
+        ) -> SafetyKit::Models::DataUpdateSettingsParams::Schema::ingest_as
+
+        def initialize: (
+          ?belongs_to: String,
+          ?content_type: SafetyKit::Models::DataUpdateSettingsParams::Schema::content_type,
+          ?display_hint: SafetyKit::DataUpdateSettingsParams::Schema::DisplayHint,
+          ?field_limit: Integer,
+          ?ingest_as: SafetyKit::Models::DataUpdateSettingsParams::Schema::ingest_as
+        ) -> void
+
+        def to_hash: -> {
+          belongs_to: String,
+          content_type: SafetyKit::Models::DataUpdateSettingsParams::Schema::content_type,
+          display_hint: SafetyKit::DataUpdateSettingsParams::Schema::DisplayHint,
+          field_limit: Integer,
+          ingest_as: SafetyKit::Models::DataUpdateSettingsParams::Schema::ingest_as
+        }
+
+        type content_type =
+          :image_url
+          | :video_url
+          | :audio_url
+          | :website_url
+          | :datetime
+          | :metadata
+          | :card
+
+        module ContentType
+          extend SafetyKit::Internal::Type::Enum
+
+          IMAGE_URL: :image_url
+          VIDEO_URL: :video_url
+          AUDIO_URL: :audio_url
+          WEBSITE_URL: :website_url
+          DATETIME: :datetime
+          METADATA: :metadata
+          CARD: :card
+
+          def self?.values: -> ::Array[SafetyKit::Models::DataUpdateSettingsParams::Schema::content_type]
+        end
+
+        type display_hint =
+          {
+            hidden: bool,
+            name: String,
+            type: SafetyKit::Models::DataUpdateSettingsParams::Schema::DisplayHint::type_
+          }
+
+        class DisplayHint < SafetyKit::Internal::Type::BaseModel
+          attr_reader hidden: bool?
+
+          def hidden=: (bool) -> bool
+
+          attr_reader name: String?
+
+          def name=: (String) -> String
+
+          attr_reader type: SafetyKit::Models::DataUpdateSettingsParams::Schema::DisplayHint::type_?
+
+          def type=: (
+            SafetyKit::Models::DataUpdateSettingsParams::Schema::DisplayHint::type_
+          ) -> SafetyKit::Models::DataUpdateSettingsParams::Schema::DisplayHint::type_
+
+          def initialize: (
+            ?hidden: bool,
+            ?name: String,
+            ?type: SafetyKit::Models::DataUpdateSettingsParams::Schema::DisplayHint::type_
+          ) -> void
+
+          def to_hash: -> {
+            hidden: bool,
+            name: String,
+            type: SafetyKit::Models::DataUpdateSettingsParams::Schema::DisplayHint::type_
+          }
+
+          type type_ =
+            :title
+            | :subtitle
+            | :category
+            | :identifier
+            | :canonical_url
+            | :status
+            | :primary_tag_set
+            | :tag_set
+            | :timestamp
+            | :rating
+            | :summary
+            | :profile_image
+            | :primary_image
+            | :image_set
+            | :video_set
+            | :audio_set
+            | :body
+            | :thread
+            | :two_person_chat
+            | :message
+            | :profile
+            | :money
+            | :location
+            | :attribute_group
+            | :attribute
+
+          module Type
+            extend SafetyKit::Internal::Type::Enum
+
+            TITLE: :title
+            SUBTITLE: :subtitle
+            CATEGORY: :category
+            IDENTIFIER: :identifier
+            CANONICAL_URL: :canonical_url
+            STATUS: :status
+            PRIMARY_TAG_SET: :primary_tag_set
+            TAG_SET: :tag_set
+            TIMESTAMP: :timestamp
+            RATING: :rating
+            SUMMARY: :summary
+            PROFILE_IMAGE: :profile_image
+            PRIMARY_IMAGE: :primary_image
+            IMAGE_SET: :image_set
+            VIDEO_SET: :video_set
+            AUDIO_SET: :audio_set
+            BODY: :body
+            THREAD: :thread
+            TWO_PERSON_CHAT: :two_person_chat
+            MESSAGE: :message
+            PROFILE: :profile
+            MONEY: :money
+            LOCATION: :location
+            ATTRIBUTE_GROUP: :attribute_group
+            ATTRIBUTE: :attribute
+
+            def self?.values: -> ::Array[SafetyKit::Models::DataUpdateSettingsParams::Schema::DisplayHint::type_]
+          end
+        end
+
+        type ingest_as = :float | :datetime
+
+        module IngestAs
+          extend SafetyKit::Internal::Type::Enum
+
+          FLOAT: :float
+          DATETIME: :datetime
+
+          def self?.values: -> ::Array[SafetyKit::Models::DataUpdateSettingsParams::Schema::ingest_as]
+        end
+      end
+    end
+  end
+end

data/sig/safety_kit/models/data_update_settings_response.rbs

@@ -0,0 +1,35 @@
+module SafetyKit
+  module Models
+    type data_update_settings_response =
+      {
+        namespace: String,
+        status: SafetyKit::Models::DataUpdateSettingsResponse::status
+      }
+
+    class DataUpdateSettingsResponse < SafetyKit::Internal::Type::BaseModel
+      attr_accessor namespace: String
+
+      attr_accessor status: SafetyKit::Models::DataUpdateSettingsResponse::status
+
+      def initialize: (
+        namespace: String,
+        status: SafetyKit::Models::DataUpdateSettingsResponse::status
+      ) -> void
+
+      def to_hash: -> {
+        namespace: String,
+        status: SafetyKit::Models::DataUpdateSettingsResponse::status
+      }
+
+      type status = :updated
+
+      module Status
+        extend SafetyKit::Internal::Type::Enum
+
+        UPDATED: :updated
+
+        def self?.values: -> ::Array[SafetyKit::Models::DataUpdateSettingsResponse::status]
+      end
+    end
+  end
+end

data/sig/safety_kit/models.rbs

@@ -17,6 +17,8 @@ module SafetyKit
 
   class DataObject = SafetyKit::Models::DataObject
 
+  class DataUpdateSettingsParams = SafetyKit::Models::DataUpdateSettingsParams
+
   class DeletionRequestCreateParams = SafetyKit::Models::DeletionRequestCreateParams
 
   class StreamAddFrameParams = SafetyKit::Models::StreamAddFrameParams

data/sig/safety_kit/resources/data.rbs

@@ -24,6 +24,13 @@ module SafetyKit
         ?request_options: SafetyKit::request_opts
       ) -> SafetyKit::Models::DataGetStatusResponse
 
+      def update_settings: (
+        String namespace,
+        ?schema: ::Hash[Symbol, SafetyKit::DataUpdateSettingsParams::Schema],
+        ?settings: ::Hash[Symbol, top?],
+        ?request_options: SafetyKit::request_opts
+      ) -> SafetyKit::Models::DataUpdateSettingsResponse
+
       def initialize: (client: SafetyKit::Client) -> void
     end
   end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: safetykit
 version: !ruby/object:Gem::Version
-  version: 0.40.0
+  version: 0.41.0
 platform: ruby
 authors:
 - Safetykit
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-07-15 00:00:00.000000000 Z
+date: 2026-07-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi
@@ -86,6 +86,8 @@ files:
 - lib/safety_kit/models/data_get_status_params.rb
 - lib/safety_kit/models/data_get_status_response.rb
 - lib/safety_kit/models/data_object.rb
+- lib/safety_kit/models/data_update_settings_params.rb
+- lib/safety_kit/models/data_update_settings_response.rb
 - lib/safety_kit/models/deletion_request_create_params.rb
 - lib/safety_kit/models/deletion_request_create_response.rb
 - lib/safety_kit/models/stream_add_frame_params.rb
@@ -141,6 +143,8 @@ files:
 - rbi/safety_kit/models/data_get_status_params.rbi
 - rbi/safety_kit/models/data_get_status_response.rbi
 - rbi/safety_kit/models/data_object.rbi
+- rbi/safety_kit/models/data_update_settings_params.rbi
+- rbi/safety_kit/models/data_update_settings_response.rbi
 - rbi/safety_kit/models/deletion_request_create_params.rbi
 - rbi/safety_kit/models/deletion_request_create_response.rbi
 - rbi/safety_kit/models/stream_add_frame_params.rbi
@@ -195,6 +199,8 @@ files:
 - sig/safety_kit/models/data_get_status_params.rbs
 - sig/safety_kit/models/data_get_status_response.rbs
 - sig/safety_kit/models/data_object.rbs
+- sig/safety_kit/models/data_update_settings_params.rbs
+- sig/safety_kit/models/data_update_settings_response.rbs
 - sig/safety_kit/models/deletion_request_create_params.rbs
 - sig/safety_kit/models/deletion_request_create_response.rbs
 - sig/safety_kit/models/stream_add_frame_params.rbs