safetykit 0.62.0 → 0.64.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8f5ba2319763d7b6d9c2efb54f5c4f2fbb38e8f1ad5a3e13e9263489462a655b
-  data.tar.gz: ea534ef3d9af074b20402b4116c9b5603928d859d5e0397db00327c73bb68b0e
+  metadata.gz: 6008e0325c4a55331b32202f0042aa80776a3fa3f03590ccc23a79b4f7c223c6
+  data.tar.gz: e09c4d9df7fb7efc00717e0bacac8c893267f1cb1fad96e09075475126dd07b3
 SHA512:
-  metadata.gz: d0003cb3fc891f5e4bab459017dee09977aa213a0a203003b95959c6a8e450c996702eeed8fc477406f58850562f87668ce012fb039cc5dd2558b349d63e106a
-  data.tar.gz: 6a5af12159936f30f5dd14c894581d27d96b990be0793bb9fb539775cd00459fd4403a737eebd8db196cc383d28a61502587ce8351e7a5fcabcb803463cd2cdd
+  metadata.gz: 51a30dc4f05ce0d79dcb586524f05805ed24c2f17a70537b48927126b4efa5f91baad779a9e4f141a0dd4b4047b2f215fcd3b6ec37d45ff165e6bb4fd166fd99
+  data.tar.gz: fb0a690a1c12e3dae1fa06a5a2325d1684b918180f25848113c85a3dda558f1da0797875c1d82ebb6a45fa583d761af35d8f0f6182ec8083fd9f6e69eece4344

data/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 0.64.0 (2026-08-20)
+
+Full Changelog: [v0.63.0...v0.64.0](https://github.com/GetSafetyKit/safetykit-ruby/compare/v0.63.0...v0.64.0)
+
+### Features
+
+* **api:** api update ([1931e07](https://github.com/GetSafetyKit/safetykit-ruby/commit/1931e07d454e90ef8fd8c67022ed2377e4d86293))
+
+## 0.63.0 (2026-08-19)
+
+Full Changelog: [v0.62.0...v0.63.0](https://github.com/GetSafetyKit/safetykit-ruby/compare/v0.62.0...v0.63.0)
+
+### Features
+
+* **api:** api update ([9cecd7f](https://github.com/GetSafetyKit/safetykit-ruby/commit/9cecd7fef16f48e93b3093b4dda18418413b44e9))
+
 ## 0.62.0 (2026-08-13)
 
 Full Changelog: [v0.61.0...v0.62.0](https://github.com/GetSafetyKit/safetykit-ruby/compare/v0.61.0...v0.62.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.62.0"
+gem "safetykit", "~> 0.64.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/safety_kit/models/content_create_params.rb

@@ -29,7 +29,8 @@ module SafetyKit
       optional :content_id, String
 
       # @!attribute metadata
-      #   Additional product context for this content. At most 8KB when serialized.
+      #   Additional product context for this content, echoed back unchanged on the
+      #   response. At most 8KB when serialized.
       #
       #   @return [Hash{Symbol=>Object, nil}, nil]
       optional :metadata, SafetyKit::Internal::Type::HashOf[SafetyKit::Internal::Type::Unknown, nil?: true]
@@ -50,7 +51,7 @@ module SafetyKit
       #
       #   @param content_id [String] Your content identifier.
       #
-      #   @param metadata [Hash{Symbol=>Object, nil}] Additional product context for this content. At most 8KB when serialized.
+      #   @param metadata [Hash{Symbol=>Object, nil}] Additional product context for this content, echoed back unchanged on the respon
       #
       #   @param safety_kit_version [Symbol, SafetyKit::Models::ContentCreateParams::SafetyKitVersion] The API version this operation is defined against.
       #

data/lib/safety_kit/models/content_create_response.rb

@@ -29,7 +29,17 @@ module SafetyKit
       #   @return [String]
       required :version, String
 
-      # @!method initialize(content_id:, labels:, user_id:, version:)
+      # @!attribute metadata
+      #   The metadata from the request, echoed back unchanged. Absent when the request
+      #   sent none.
+      #
+      #   @return [Hash{Symbol=>Object, nil}, nil]
+      optional :metadata, SafetyKit::Internal::Type::HashOf[SafetyKit::Internal::Type::Unknown, nil?: true]
+
+      # @!method initialize(content_id:, labels:, user_id:, version:, metadata: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {SafetyKit::Models::ContentCreateResponse} for more details.
+      #
       #   Synchronous classification result for the submitted content.
       #
       #   @param content_id [String] SafetyKit identifier for the classified content.
@@ -39,6 +49,8 @@ module SafetyKit
       #   @param user_id [String] The user_id from the request.
       #
       #   @param version [String] The API version that served this request.
+      #
+      #   @param metadata [Hash{Symbol=>Object, nil}] The metadata from the request, echoed back unchanged. Absent when the request se
 
       # Result for one label evaluated against the submitted content.
       module Label

data/lib/safety_kit/models/data_get_settings_params.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module SafetyKit
+  module Models
+    # @see SafetyKit::Resources::Data#get_settings
+    class DataGetSettingsParams < 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
+
+      # @!method initialize(namespace:, request_options: {})
+      #   @param namespace [String] The namespace to ingest data into
+      #
+      #   @param request_options [SafetyKit::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/safety_kit/models/data_get_settings_response.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+module SafetyKit
+  module Models
+    # @see SafetyKit::Resources::Data#get_settings
+    class DataGetSettingsResponse < SafetyKit::Internal::Type::BaseModel
+      # @!attribute namespace
+      #
+      #   @return [String]
+      required :namespace, String
+
+      # @!attribute schema
+      #   The stored schema for this namespace, returned exactly as stored.
+      #
+      #   @return [Hash{Symbol=>Object, nil}]
+      required :schema, SafetyKit::Internal::Type::HashOf[SafetyKit::Internal::Type::Unknown, nil?: true]
+
+      # @!attribute settings
+      #   The stored namespace settings. Configure with guidance from SafetyKit.
+      #
+      #   @return [Hash{Symbol=>Object, nil}]
+      required :settings, SafetyKit::Internal::Type::HashOf[SafetyKit::Internal::Type::Unknown, nil?: true]
+
+      # @!attribute version
+      #   The current configuration version, incremented each time the configuration is
+      #   updated through the API or by SafetyKit. Send it as previous_version when
+      #   updating to detect intervening changes.
+      #
+      #   @return [Integer]
+      required :version, Integer
+
+      # @!method initialize(namespace:, schema:, settings:, version:)
+      #   Some parameter documentations has been truncated, see
+      #   {SafetyKit::Models::DataGetSettingsResponse} for more details.
+      #
+      #   The namespace's stored configuration and its current version.
+      #
+      #   @param namespace [String]
+      #
+      #   @param schema [Hash{Symbol=>Object, nil}] The stored schema for this namespace, returned exactly as stored.
+      #
+      #   @param settings [Hash{Symbol=>Object, nil}] The stored namespace settings. Configure with guidance from SafetyKit.
+      #
+      #   @param version [Integer] The current configuration version, incremented each time the configuration is up
+    end
+  end
+end

data/lib/safety_kit/models/data_update_settings_params.rb

@@ -13,6 +13,15 @@ module SafetyKit
       #   @return [String]
       required :namespace, String
 
+      # @!attribute previous_version
+      #   The version returned by GET (or a prior update). When provided, the update is
+      #   rejected with 409 if the stored configuration has changed since that read, so a
+      #   stale sync cannot overwrite a newer update. Strongly recommended for automated
+      #   schema syncs.
+      #
+      #   @return [Integer, nil]
+      optional :previous_version, Integer
+
       # @!attribute schema
       #   New schema to store for this namespace. Omit to leave the existing schema
       #   unchanged.
@@ -27,12 +36,14 @@ module 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: {})
+      # @!method initialize(namespace:, previous_version: nil, 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 previous_version [Integer] The version returned by GET (or a prior update). When provided, the update is re
+      #
       #   @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

data/lib/safety_kit/models/data_update_settings_response.rb

@@ -14,11 +14,24 @@ module SafetyKit
       #   @return [Symbol, SafetyKit::Models::DataUpdateSettingsResponse::Status]
       required :status, enum: -> { SafetyKit::Models::DataUpdateSettingsResponse::Status }
 
-      # @!method initialize(namespace:, status:)
+      # @!attribute version
+      #   The configuration version after this update. Send it as previous_version on your
+      #   next update to detect intervening changes.
+      #
+      #   @return [Integer]
+      required :version, Integer
+
+      # @!method initialize(namespace:, status:, version:)
+      #   Some parameter documentations has been truncated, see
+      #   {SafetyKit::Models::DataUpdateSettingsResponse} for more details.
+      #
       #   Namespace configuration was stored.
       #
       #   @param namespace [String]
+      #
       #   @param status [Symbol, SafetyKit::Models::DataUpdateSettingsResponse::Status]
+      #
+      #   @param version [Integer] The configuration version after this update. Send it as previous_version on your
 
       # @see SafetyKit::Models::DataUpdateSettingsResponse#status
       module Status

data/lib/safety_kit/models.rb

@@ -57,6 +57,8 @@ module SafetyKit
 
   DataGetDownloadURLParams = SafetyKit::Models::DataGetDownloadURLParams
 
+  DataGetSettingsParams = SafetyKit::Models::DataGetSettingsParams
+
   DataGetStatusParams = SafetyKit::Models::DataGetStatusParams
 
   DataObject = SafetyKit::Models::DataObject

data/lib/safety_kit/resources/content.rb

@@ -9,8 +9,10 @@ module SafetyKit
       # {SafetyKit::Models::ContentCreateParams} for more details.
       #
       # Classify a piece of content synchronously. Send text and image parts and receive
-      # per-label results in the response. Requests have a maximum size of 6MB. API
-      # version 2026-08-11; see the API versioning guide for superseded versions.
+      # per-label results in the response. Any metadata you send is echoed back on the
+      # response, so a decision can be matched to your own request without a side
+      # lookup. Requests have a maximum size of 6MB. API version 2026-08-11; see the API
+      # versioning guide for superseded versions.
       #
       # Errors: 400 for an invalid body or images, with the failing field in the
       # message. 401 for a missing or invalid API key. 413 for requests over 6MB. 429
@@ -26,7 +28,7 @@ module SafetyKit
       #
       # @param content_id [String] Body param: Your content identifier.
       #
-      # @param metadata [Hash{Symbol=>Object, nil}] Body param: Additional product context for this content. At most 8KB when serial
+      # @param metadata [Hash{Symbol=>Object, nil}] Body param: Additional product context for this content, echoed back unchanged o
       #
       # @param safety_kit_version [Symbol, SafetyKit::Models::ContentCreateParams::SafetyKitVersion] Header param: The API version this operation is defined against.
       #

data/lib/safety_kit/resources/data.rb

@@ -83,6 +83,28 @@ module SafetyKit
         )
       end
 
+      # Fetch the stored schema, settings, and configuration version for a namespace.
+      # Use the returned version as previous_version when updating so a stale update is
+      # rejected instead of overwriting a newer one.
+      #
+      # @overload get_settings(namespace, request_options: {})
+      #
+      # @param namespace [String] The namespace to ingest data into
+      #
+      # @param request_options [SafetyKit::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [SafetyKit::Models::DataGetSettingsResponse]
+      #
+      # @see SafetyKit::Models::DataGetSettingsParams
+      def get_settings(namespace, params = {})
+        @client.request(
+          method: :get,
+          path: ["v1/data/%1$s/settings", namespace],
+          model: SafetyKit::Models::DataGetSettingsResponse,
+          options: params[:request_options]
+        )
+      end
+
       # Retrieve the status of a data ingestion request and, once complete, return
       # processed objects inline. If the processed output exceeds the 5 MiB inline
       # response limit, this endpoint returns an error instructing you to use the
@@ -116,14 +138,16 @@ module SafetyKit
       # 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
+      # Update the schema and/or settings for a namespace. Each is replaced in full when
+      # provided and left unchanged when omitted. Namespaces whose configuration is
       # managed by SafetyKit cannot be updated through this endpoint.
       #
-      # @overload update_settings(namespace, schema: nil, settings: nil, request_options: {})
+      # @overload update_settings(namespace, previous_version: nil, schema: nil, settings: nil, request_options: {})
       #
       # @param namespace [String] The namespace to ingest data into
       #
+      # @param previous_version [Integer] The version returned by GET (or a prior update). When provided, the update is re
+      #
       # @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

data/lib/safety_kit/version.rb

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

data/lib/safety_kit.rb

@@ -70,6 +70,8 @@ require_relative "safety_kit/models/data_create_upload_url_params"
 require_relative "safety_kit/models/data_create_upload_url_response"
 require_relative "safety_kit/models/data_get_download_url_params"
 require_relative "safety_kit/models/data_get_download_url_response"
+require_relative "safety_kit/models/data_get_settings_params"
+require_relative "safety_kit/models/data_get_settings_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"

data/rbi/safety_kit/models/content_create_params.rbi

@@ -37,7 +37,8 @@ module SafetyKit
       sig { params(content_id: String).void }
       attr_writer :content_id
 
-      # Additional product context for this content. At most 8KB when serialized.
+      # Additional product context for this content, echoed back unchanged on the
+      # response. At most 8KB when serialized.
       sig { returns(T.nilable(T::Hash[Symbol, T.nilable(T.anything)])) }
       attr_reader :metadata
 
@@ -86,7 +87,8 @@ module SafetyKit
         user_id:,
         # Your content identifier.
         content_id: nil,
-        # Additional product context for this content. At most 8KB when serialized.
+        # Additional product context for this content, echoed back unchanged on the
+        # response. At most 8KB when serialized.
         metadata: nil,
         # The API version this operation is defined against.
         safety_kit_version: nil,

data/rbi/safety_kit/models/content_create_response.rbi

@@ -31,6 +31,14 @@ module SafetyKit
       sig { returns(String) }
       attr_accessor :version
 
+      # The metadata from the request, echoed back unchanged. Absent when the request
+      # sent none.
+      sig { returns(T.nilable(T::Hash[Symbol, T.nilable(T.anything)])) }
+      attr_reader :metadata
+
+      sig { params(metadata: T::Hash[Symbol, T.nilable(T.anything)]).void }
+      attr_writer :metadata
+
       # Synchronous classification result for the submitted content.
       sig do
         params(
@@ -43,7 +51,8 @@ module SafetyKit
               )
             ],
           user_id: String,
-          version: String
+          version: String,
+          metadata: T::Hash[Symbol, T.nilable(T.anything)]
         ).returns(T.attached_class)
       end
       def self.new(
@@ -54,7 +63,10 @@ module SafetyKit
         # The user_id from the request.
         user_id:,
         # The API version that served this request.
-        version:
+        version:,
+        # The metadata from the request, echoed back unchanged. Absent when the request
+        # sent none.
+        metadata: nil
       )
       end
 
@@ -67,7 +79,8 @@ module SafetyKit
                 SafetyKit::Models::ContentCreateResponse::Label::Variants
               ],
             user_id: String,
-            version: String
+            version: String,
+            metadata: T::Hash[Symbol, T.nilable(T.anything)]
           }
         )
       end

data/rbi/safety_kit/models/data_get_settings_params.rbi

@@ -0,0 +1,40 @@
+# typed: strong
+
+module SafetyKit
+  module Models
+    class DataGetSettingsParams < SafetyKit::Internal::Type::BaseModel
+      extend SafetyKit::Internal::Type::RequestParameters::Converter
+      include SafetyKit::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(SafetyKit::DataGetSettingsParams, SafetyKit::Internal::AnyHash)
+        end
+
+      # The namespace to ingest data into
+      sig { returns(String) }
+      attr_accessor :namespace
+
+      sig do
+        params(
+          namespace: String,
+          request_options: SafetyKit::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # The namespace to ingest data into
+        namespace:,
+        request_options: {}
+      )
+      end
+
+      sig do
+        override.returns(
+          { namespace: String, request_options: SafetyKit::RequestOptions }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/safety_kit/models/data_get_settings_response.rbi

@@ -0,0 +1,67 @@
+# typed: strong
+
+module SafetyKit
+  module Models
+    class DataGetSettingsResponse < SafetyKit::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            SafetyKit::Models::DataGetSettingsResponse,
+            SafetyKit::Internal::AnyHash
+          )
+        end
+
+      sig { returns(String) }
+      attr_accessor :namespace
+
+      # The stored schema for this namespace, returned exactly as stored.
+      sig { returns(T::Hash[Symbol, T.nilable(T.anything)]) }
+      attr_accessor :schema
+
+      # The stored namespace settings. Configure with guidance from SafetyKit.
+      sig { returns(T::Hash[Symbol, T.nilable(T.anything)]) }
+      attr_accessor :settings
+
+      # The current configuration version, incremented each time the configuration is
+      # updated through the API or by SafetyKit. Send it as previous_version when
+      # updating to detect intervening changes.
+      sig { returns(Integer) }
+      attr_accessor :version
+
+      # The namespace's stored configuration and its current version.
+      sig do
+        params(
+          namespace: String,
+          schema: T::Hash[Symbol, T.nilable(T.anything)],
+          settings: T::Hash[Symbol, T.nilable(T.anything)],
+          version: Integer
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        namespace:,
+        # The stored schema for this namespace, returned exactly as stored.
+        schema:,
+        # The stored namespace settings. Configure with guidance from SafetyKit.
+        settings:,
+        # The current configuration version, incremented each time the configuration is
+        # updated through the API or by SafetyKit. Send it as previous_version when
+        # updating to detect intervening changes.
+        version:
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            namespace: String,
+            schema: T::Hash[Symbol, T.nilable(T.anything)],
+            settings: T::Hash[Symbol, T.nilable(T.anything)],
+            version: Integer
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/safety_kit/models/data_update_settings_params.rbi

@@ -18,6 +18,16 @@ module SafetyKit
       sig { returns(String) }
       attr_accessor :namespace
 
+      # The version returned by GET (or a prior update). When provided, the update is
+      # rejected with 409 if the stored configuration has changed since that read, so a
+      # stale sync cannot overwrite a newer update. Strongly recommended for automated
+      # schema syncs.
+      sig { returns(T.nilable(Integer)) }
+      attr_reader :previous_version
+
+      sig { params(previous_version: Integer).void }
+      attr_writer :previous_version
+
       # New schema to store for this namespace. Omit to leave the existing schema
       # unchanged.
       sig do
@@ -48,6 +58,7 @@ module SafetyKit
       sig do
         params(
           namespace: String,
+          previous_version: Integer,
           schema:
             T::Hash[
               Symbol,
@@ -60,6 +71,11 @@ module SafetyKit
       def self.new(
         # The namespace to ingest data into
         namespace:,
+        # The version returned by GET (or a prior update). When provided, the update is
+        # rejected with 409 if the stored configuration has changed since that read, so a
+        # stale sync cannot overwrite a newer update. Strongly recommended for automated
+        # schema syncs.
+        previous_version: nil,
         # New schema to store for this namespace. Omit to leave the existing schema
         # unchanged.
         schema: nil,
@@ -74,6 +90,7 @@ module SafetyKit
         override.returns(
           {
             namespace: String,
+            previous_version: Integer,
             schema:
               T::Hash[Symbol, SafetyKit::DataUpdateSettingsParams::Schema],
             settings: T::Hash[Symbol, T.nilable(T.anything)],

data/rbi/safety_kit/models/data_update_settings_response.rbi

@@ -21,15 +21,27 @@ module SafetyKit
       end
       attr_accessor :status
 
+      # The configuration version after this update. Send it as previous_version on your
+      # next update to detect intervening changes.
+      sig { returns(Integer) }
+      attr_accessor :version
+
       # Namespace configuration was stored.
       sig do
         params(
           namespace: String,
           status:
-            SafetyKit::Models::DataUpdateSettingsResponse::Status::OrSymbol
+            SafetyKit::Models::DataUpdateSettingsResponse::Status::OrSymbol,
+          version: Integer
         ).returns(T.attached_class)
       end
-      def self.new(namespace:, status:)
+      def self.new(
+        namespace:,
+        status:,
+        # The configuration version after this update. Send it as previous_version on your
+        # next update to detect intervening changes.
+        version:
+      )
       end
 
       sig do
@@ -37,7 +49,8 @@ module SafetyKit
           {
             namespace: String,
             status:
-              SafetyKit::Models::DataUpdateSettingsResponse::Status::TaggedSymbol
+              SafetyKit::Models::DataUpdateSettingsResponse::Status::TaggedSymbol,
+            version: Integer
           }
         )
       end

data/rbi/safety_kit/models.rbi

@@ -22,6 +22,8 @@ module SafetyKit
 
   DataGetDownloadURLParams = SafetyKit::Models::DataGetDownloadURLParams
 
+  DataGetSettingsParams = SafetyKit::Models::DataGetSettingsParams
+
   DataGetStatusParams = SafetyKit::Models::DataGetStatusParams
 
   DataObject = SafetyKit::Models::DataObject

data/rbi/safety_kit/resources/content.rbi

@@ -6,8 +6,10 @@ module SafetyKit
     # the response.
     class Content
       # Classify a piece of content synchronously. Send text and image parts and receive
-      # per-label results in the response. Requests have a maximum size of 6MB. API
-      # version 2026-08-11; see the API versioning guide for superseded versions.
+      # per-label results in the response. Any metadata you send is echoed back on the
+      # response, so a decision can be matched to your own request without a side
+      # lookup. Requests have a maximum size of 6MB. API version 2026-08-11; see the API
+      # versioning guide for superseded versions.
       #
       # Errors: 400 for an invalid body or images, with the failing field in the
       # message. 401 for a missing or invalid API key. 413 for requests over 6MB. 429
@@ -40,8 +42,8 @@ module SafetyKit
         user_id:,
         # Body param: Your content identifier.
         content_id: nil,
-        # Body param: Additional product context for this content. At most 8KB when
-        # serialized.
+        # Body param: Additional product context for this content, echoed back unchanged
+        # on the response. At most 8KB when serialized.
         metadata: nil,
         # Header param: The API version this operation is defined against.
         safety_kit_version: nil,

data/rbi/safety_kit/resources/data.rbi

@@ -62,6 +62,22 @@ module SafetyKit
       )
       end
 
+      # Fetch the stored schema, settings, and configuration version for a namespace.
+      # Use the returned version as previous_version when updating so a stale update is
+      # rejected instead of overwriting a newer one.
+      sig do
+        params(
+          namespace: String,
+          request_options: SafetyKit::RequestOptions::OrHash
+        ).returns(SafetyKit::Models::DataGetSettingsResponse)
+      end
+      def get_settings(
+        # The namespace to ingest data into
+        namespace,
+        request_options: {}
+      )
+      end
+
       # Retrieve the status of a data ingestion request and, once complete, return
       # processed objects inline. If the processed output exceeds the 5 MiB inline
       # response limit, this endpoint returns an error instructing you to use the
@@ -82,12 +98,13 @@ 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
+      # Update the schema and/or settings for a namespace. Each is replaced in full when
+      # provided and left unchanged when omitted. Namespaces whose configuration is
       # managed by SafetyKit cannot be updated through this endpoint.
       sig do
         params(
           namespace: String,
+          previous_version: Integer,
           schema:
             T::Hash[
               Symbol,
@@ -100,6 +117,11 @@ module SafetyKit
       def update_settings(
         # The namespace to ingest data into
         namespace,
+        # The version returned by GET (or a prior update). When provided, the update is
+        # rejected with 409 if the stored configuration has changed since that read, so a
+        # stale sync cannot overwrite a newer update. Strongly recommended for automated
+        # schema syncs.
+        previous_version: nil,
         # New schema to store for this namespace. Omit to leave the existing schema
         # unchanged.
         schema: nil,

data/sig/safety_kit/models/content_create_response.rbs

@@ -5,7 +5,8 @@ module SafetyKit
         content_id: String,
         labels: ::Array[SafetyKit::Models::ContentCreateResponse::label],
         user_id: String,
-        version: String
+        version: String,
+        metadata: ::Hash[Symbol, top?]
       }
 
     class ContentCreateResponse < SafetyKit::Internal::Type::BaseModel
@@ -17,18 +18,24 @@ module SafetyKit
 
       attr_accessor version: String
 
+      attr_reader metadata: ::Hash[Symbol, top?]?
+
+      def metadata=: (::Hash[Symbol, top?]) -> ::Hash[Symbol, top?]
+
       def initialize: (
         content_id: String,
         labels: ::Array[SafetyKit::Models::ContentCreateResponse::label],
         user_id: String,
-        version: String
+        version: String,
+        ?metadata: ::Hash[Symbol, top?]
       ) -> void
 
       def to_hash: -> {
         content_id: String,
         labels: ::Array[SafetyKit::Models::ContentCreateResponse::label],
         user_id: String,
-        version: String
+        version: String,
+        metadata: ::Hash[Symbol, top?]
       }
 
       type label =

data/sig/safety_kit/models/data_get_settings_params.rbs

@@ -0,0 +1,23 @@
+module SafetyKit
+  module Models
+    type data_get_settings_params =
+      { namespace: String } & SafetyKit::Internal::Type::request_parameters
+
+    class DataGetSettingsParams < SafetyKit::Internal::Type::BaseModel
+      extend SafetyKit::Internal::Type::RequestParameters::Converter
+      include SafetyKit::Internal::Type::RequestParameters
+
+      attr_accessor namespace: String
+
+      def initialize: (
+        namespace: String,
+        ?request_options: SafetyKit::request_opts
+      ) -> void
+
+      def to_hash: -> {
+        namespace: String,
+        request_options: SafetyKit::RequestOptions
+      }
+    end
+  end
+end

data/sig/safety_kit/models/data_get_settings_response.rbs

@@ -0,0 +1,35 @@
+module SafetyKit
+  module Models
+    type data_get_settings_response =
+      {
+        namespace: String,
+        schema: ::Hash[Symbol, top?],
+        settings: ::Hash[Symbol, top?],
+        version: Integer
+      }
+
+    class DataGetSettingsResponse < SafetyKit::Internal::Type::BaseModel
+      attr_accessor namespace: String
+
+      attr_accessor schema: ::Hash[Symbol, top?]
+
+      attr_accessor settings: ::Hash[Symbol, top?]
+
+      attr_accessor version: Integer
+
+      def initialize: (
+        namespace: String,
+        schema: ::Hash[Symbol, top?],
+        settings: ::Hash[Symbol, top?],
+        version: Integer
+      ) -> void
+
+      def to_hash: -> {
+        namespace: String,
+        schema: ::Hash[Symbol, top?],
+        settings: ::Hash[Symbol, top?],
+        version: Integer
+      }
+    end
+  end
+end

data/sig/safety_kit/models/data_update_settings_params.rbs

@@ -3,6 +3,7 @@ module SafetyKit
     type data_update_settings_params =
       {
         namespace: String,
+        previous_version: Integer,
         schema: ::Hash[Symbol, SafetyKit::DataUpdateSettingsParams::Schema],
         settings: ::Hash[Symbol, top?]
       }
@@ -14,6 +15,10 @@ module SafetyKit
 
       attr_accessor namespace: String
 
+      attr_reader previous_version: Integer?
+
+      def previous_version=: (Integer) -> Integer
+
       attr_reader schema: ::Hash[Symbol, SafetyKit::DataUpdateSettingsParams::Schema]?
 
       def schema=: (
@@ -26,6 +31,7 @@ module SafetyKit
 
       def initialize: (
         namespace: String,
+        ?previous_version: Integer,
         ?schema: ::Hash[Symbol, SafetyKit::DataUpdateSettingsParams::Schema],
         ?settings: ::Hash[Symbol, top?],
         ?request_options: SafetyKit::request_opts
@@ -33,6 +39,7 @@ module SafetyKit
 
       def to_hash: -> {
         namespace: String,
+        previous_version: Integer,
         schema: ::Hash[Symbol, SafetyKit::DataUpdateSettingsParams::Schema],
         settings: ::Hash[Symbol, top?],
         request_options: SafetyKit::RequestOptions

data/sig/safety_kit/models/data_update_settings_response.rbs

@@ -3,7 +3,8 @@ module SafetyKit
     type data_update_settings_response =
       {
         namespace: String,
-        status: SafetyKit::Models::DataUpdateSettingsResponse::status
+        status: SafetyKit::Models::DataUpdateSettingsResponse::status,
+        version: Integer
       }
 
     class DataUpdateSettingsResponse < SafetyKit::Internal::Type::BaseModel
@@ -11,14 +12,18 @@ module SafetyKit
 
       attr_accessor status: SafetyKit::Models::DataUpdateSettingsResponse::status
 
+      attr_accessor version: Integer
+
       def initialize: (
         namespace: String,
-        status: SafetyKit::Models::DataUpdateSettingsResponse::status
+        status: SafetyKit::Models::DataUpdateSettingsResponse::status,
+        version: Integer
       ) -> void
 
       def to_hash: -> {
         namespace: String,
-        status: SafetyKit::Models::DataUpdateSettingsResponse::status
+        status: SafetyKit::Models::DataUpdateSettingsResponse::status,
+        version: Integer
       }
 
       type status = :updated

data/sig/safety_kit/models.rbs

@@ -17,6 +17,8 @@ module SafetyKit
 
   class DataGetDownloadURLParams = SafetyKit::Models::DataGetDownloadURLParams
 
+  class DataGetSettingsParams = SafetyKit::Models::DataGetSettingsParams
+
   class DataGetStatusParams = SafetyKit::Models::DataGetStatusParams
 
   class DataObject = SafetyKit::Models::DataObject

data/sig/safety_kit/resources/data.rbs

@@ -18,6 +18,11 @@ module SafetyKit
         ?request_options: SafetyKit::request_opts
       ) -> SafetyKit::Models::DataGetDownloadURLResponse
 
+      def get_settings: (
+        String namespace,
+        ?request_options: SafetyKit::request_opts
+      ) -> SafetyKit::Models::DataGetSettingsResponse
+
       def get_status: (
         String request_id,
         namespace: String,
@@ -26,6 +31,7 @@ module SafetyKit
 
       def update_settings: (
         String namespace,
+        ?previous_version: Integer,
         ?schema: ::Hash[Symbol, SafetyKit::DataUpdateSettingsParams::Schema],
         ?settings: ::Hash[Symbol, top?],
         ?request_options: SafetyKit::request_opts

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: safetykit
 version: !ruby/object:Gem::Version
-  version: 0.62.0
+  version: 0.64.0
 platform: ruby
 authors:
 - Safetykit
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-08-13 00:00:00.000000000 Z
+date: 2026-08-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi
@@ -87,6 +87,8 @@ files:
 - lib/safety_kit/models/data_create_upload_url_response.rb
 - lib/safety_kit/models/data_get_download_url_params.rb
 - lib/safety_kit/models/data_get_download_url_response.rb
+- lib/safety_kit/models/data_get_settings_params.rb
+- lib/safety_kit/models/data_get_settings_response.rb
 - 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
@@ -150,6 +152,8 @@ files:
 - rbi/safety_kit/models/data_create_upload_url_response.rbi
 - rbi/safety_kit/models/data_get_download_url_params.rbi
 - rbi/safety_kit/models/data_get_download_url_response.rbi
+- rbi/safety_kit/models/data_get_settings_params.rbi
+- rbi/safety_kit/models/data_get_settings_response.rbi
 - 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
@@ -212,6 +216,8 @@ files:
 - sig/safety_kit/models/data_create_upload_url_response.rbs
 - sig/safety_kit/models/data_get_download_url_params.rbs
 - sig/safety_kit/models/data_get_download_url_response.rbs
+- sig/safety_kit/models/data_get_settings_params.rbs
+- sig/safety_kit/models/data_get_settings_response.rbs
 - 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