safetykit 0.50.0 → 0.52.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3be0223c948a999f249d8f68585345ec7d96040de4b4b18256a29d7af8b1b662
-  data.tar.gz: 9863631b6583962919497f97a27ddbde318e13b18d66ed3ccc724d1cd0f924c7
+  metadata.gz: fb740cd06fd2147d66523afd833977860625eba2fa2b3b85dba5933a46f68a74
+  data.tar.gz: 49974de3af4a1b8188a16cd72999a6eb822338e4f2cb5b5ee80739885f550aad
 SHA512:
-  metadata.gz: c1e231c7fafe07d840d93848166f1bedeef1ded22f991ab97e5c22aeb9d88a255d6de0065da5cb91c414178c327c4f65ec9e2dba62f3b38154b191ec470b9a90
-  data.tar.gz: a3369ab0dfb03b3579926ca0e8edd36bce0a927d8350f4d25bce7c8aa8da527a4868206cb7b28445dc9367e08fb4ded3d13fb5deccda8ebd39f552c08e8ea520
+  metadata.gz: bd4c8bf187f42c1ddbff83a393afd6c3e177414a1c37f62b6d1847c8457cc2de4d570d5941c6a81f13701006cd77c80f62b7919bcc26459418b6f9ca5b572fe8
+  data.tar.gz: 9bd4562815b061c8d5995cf75aa02752726f66e55cb2d8ecd5bd8893f434bd0470e403cef886e004214f20c04b35565096d731b539b27285444364e36d042989

data/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 0.52.0 (2026-08-05)
+
+Full Changelog: [v0.51.0...v0.52.0](https://github.com/GetSafetyKit/safetykit-ruby/compare/v0.51.0...v0.52.0)
+
+### Features
+
+* **api:** api update ([9d34342](https://github.com/GetSafetyKit/safetykit-ruby/commit/9d343420a3716e47e99f484881f25944a3468e43))
+
+## 0.51.0 (2026-08-05)
+
+Full Changelog: [v0.50.0...v0.51.0](https://github.com/GetSafetyKit/safetykit-ruby/compare/v0.50.0...v0.51.0)
+
+### Features
+
+* **api:** api update ([3a57f4e](https://github.com/GetSafetyKit/safetykit-ruby/commit/3a57f4e95d35ddb799c71c06db72ccedbd171560))
+
 ## 0.50.0 (2026-08-01)
 
 Full Changelog: [v0.49.0...v0.50.0](https://github.com/GetSafetyKit/safetykit-ruby/compare/v0.49.0...v0.50.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.50.0"
+gem "safetykit", "~> 0.52.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/safety_kit/client.rb

@@ -42,6 +42,11 @@ module SafetyKit
     # @return [SafetyKit::Resources::Async]
     attr_reader :async
 
+    # Classify user-authored text and images synchronously and receive a decision in
+    # the response.
+    # @return [SafetyKit::Resources::Content]
+    attr_reader :content
+
     # Submit end-user deletion requests. Accepted requests are processed
     # asynchronously.
     # @return [SafetyKit::Resources::DeletionRequests]
@@ -128,6 +133,7 @@ module SafetyKit
       @agent_decisions = SafetyKit::Resources::AgentDecisions.new(client: self)
       @access_tokens = SafetyKit::Resources::AccessTokens.new(client: self)
       @async = SafetyKit::Resources::Async.new(client: self)
+      @content = SafetyKit::Resources::Content.new(client: self)
       @deletion_requests = SafetyKit::Resources::DeletionRequests.new(client: self)
       @client_sessions = SafetyKit::Resources::ClientSessions.new(client: self)
       @beta = SafetyKit::Resources::Beta.new(client: self)

data/lib/safety_kit/models/content_create_params.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+module SafetyKit
+  module Models
+    # @see SafetyKit::Resources::Content#create
+    class ContentCreateParams < SafetyKit::Internal::Type::BaseModel
+      extend SafetyKit::Internal::Type::RequestParameters::Converter
+      include SafetyKit::Internal::Type::RequestParameters
+
+      # @!attribute entity_id
+      #   Your stable identifier for the entity this content belongs to, such as a user,
+      #   listing, or message thread.
+      #
+      #   @return [String]
+      required :entity_id, String
+
+      # @!attribute content_id
+      #   Your identifier for this content, matching the content_id sent on /v1/events.
+      #   Prevents double-counting content submitted to both endpoints.
+      #
+      #   @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 4 images, 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. At most 20000 characters. Classification is
+      #   based on the first 16,000 characters.
+      #
+      #   @return [String, nil]
+      optional :text, String
+
+      # @!method initialize(entity_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.
+      #
+      #   @param entity_id [String] Your stable identifier for the entity this content belongs to, such as a user, l
+      #
+      #   @param content_id [String] Your identifier for this content, matching the content_id sent on /v1/events. Pr
+      #
+      #   @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. At most 20000 characters. Classification is base
+      #
+      #   @param request_options [SafetyKit::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/safety_kit/models/content_create_response.rb

@@ -0,0 +1,154 @@
+# frozen_string_literal: true
+
+module SafetyKit
+  module Models
+    # @see SafetyKit::Resources::Content#create
+    class ContentCreateResponse < SafetyKit::Internal::Type::BaseModel
+      # @!attribute content_id
+      #   SafetyKit identifier for the classified content.
+      #
+      #   @return [String]
+      required :content_id, String
+
+      # @!attribute decision
+      #   SafetyKit's decision for the submitted content: approve (no violation found),
+      #   reject (violating), or review (needs human review).
+      #
+      #   @return [Symbol, SafetyKit::Models::ContentCreateResponse::Decision]
+      required :decision, enum: -> { SafetyKit::Models::ContentCreateResponse::Decision }
+
+      # @!attribute entity_id
+      #   The entity_id from the request.
+      #
+      #   @return [String]
+      required :entity_id, String
+
+      # @!attribute escalation
+      #   Escalation outcome: none (no escalation ran), completed (verdict reflected in
+      #   decision), or timed_out (decision is a provisional review).
+      #
+      #   @return [Symbol, SafetyKit::Models::ContentCreateResponse::Escalation]
+      required :escalation, enum: -> { SafetyKit::Models::ContentCreateResponse::Escalation }
+
+      # @!attribute mirrored
+      #   Whether SafetyKit mirrored the submitted content for later review.
+      #
+      #   @return [Boolean]
+      required :mirrored, SafetyKit::Internal::Type::Boolean
+
+      # @!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] }
+
+      # @!attribute scores
+      #   Classifier scores produced for the submitted content.
+      #
+      #   @return [Array<SafetyKit::Models::ContentCreateResponse::Score>]
+      required :scores,
+               -> { SafetyKit::Internal::Type::ArrayOf[SafetyKit::Models::ContentCreateResponse::Score] }
+
+      # @!method initialize(content_id:, decision:, entity_id:, escalation:, mirrored:, reference_set_matches:, scores:)
+      #   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.
+      #
+      #   @param decision [Symbol, SafetyKit::Models::ContentCreateResponse::Decision] SafetyKit's decision for the submitted content: approve (no violation found), re
+      #
+      #   @param entity_id [String] The entity_id from the request.
+      #
+      #   @param escalation [Symbol, SafetyKit::Models::ContentCreateResponse::Escalation] Escalation outcome: none (no escalation ran), completed (verdict reflected in de
+      #
+      #   @param mirrored [Boolean] Whether SafetyKit mirrored the submitted content for later review.
+      #
+      #   @param reference_set_matches [Array<SafetyKit::Models::ContentCreateResponse::ReferenceSetMatch>] Reference set matches found for the submitted content.
+      #
+      #   @param scores [Array<SafetyKit::Models::ContentCreateResponse::Score>] Classifier scores produced for the submitted content.
+
+      # SafetyKit's decision for the submitted content: approve (no violation found),
+      # reject (violating), or review (needs human review).
+      #
+      # @see SafetyKit::Models::ContentCreateResponse#decision
+      module Decision
+        extend SafetyKit::Internal::Type::Enum
+
+        APPROVE = :approve
+        REJECT = :reject
+        REVIEW = :review
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      # Escalation outcome: none (no escalation ran), completed (verdict reflected in
+      # decision), or timed_out (decision is a provisional review).
+      #
+      # @see SafetyKit::Models::ContentCreateResponse#escalation
+      module Escalation
+        extend SafetyKit::Internal::Type::Enum
+
+        NONE = :none
+        COMPLETED = :completed
+        TIMED_OUT = :timed_out
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      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.
+      end
+
+      class Score < SafetyKit::Internal::Type::BaseModel
+        # @!attribute classifier_id
+        #   Identifier of the classifier that produced this score.
+        #
+        #   @return [String]
+        required :classifier_id, String
+
+        # @!attribute score
+        #   Classifier score between 0 and 1. Higher means more likely violating.
+        #
+        #   @return [Float]
+        required :score, Float
+
+        # @!attribute version
+        #   Version of the classifier that produced this score.
+        #
+        #   @return [String]
+        required :version, String
+
+        # @!method initialize(classifier_id:, score:, version:)
+        #   Score produced by one classifier for the submitted content.
+        #
+        #   @param classifier_id [String] Identifier of the classifier that produced this score.
+        #
+        #   @param score [Float] Classifier score between 0 and 1. Higher means more likely violating.
+        #
+        #   @param version [String] Version of the classifier that produced this score.
+      end
+    end
+  end
+end

data/lib/safety_kit/models.rb

@@ -49,6 +49,8 @@ module SafetyKit
 
   ClientSessionCreateSessionParams = SafetyKit::Models::ClientSessionCreateSessionParams
 
+  ContentCreateParams = SafetyKit::Models::ContentCreateParams
+
   DataAddParams = SafetyKit::Models::DataAddParams
 
   DataCreateUploadURLParams = SafetyKit::Models::DataCreateUploadURLParams

data/lib/safety_kit/resources/content.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+module SafetyKit
+  module Resources
+    # Classify user-authored text and images synchronously and receive a decision in
+    # the response.
+    class Content
+      # Some parameter documentations has been truncated, see
+      # {SafetyKit::Models::ContentCreateParams} for more details.
+      #
+      # Classify a piece of content synchronously. Send user-authored text, images, or
+      # both, and receive a decision (approve, reject, or review) with classifier scores
+      # and reference set matches in the response. Requests have a maximum size of 6MB.
+      #
+      # @overload create(entity_id:, content_id: nil, images: nil, metadata: nil, text: nil, request_options: {})
+      #
+      # @param entity_id [String] Your stable identifier for the entity this content belongs to, such as a user, l
+      #
+      # @param content_id [String] Your identifier for this content, matching the content_id sent on /v1/events. Pr
+      #
+      # @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. At most 20000 characters. Classification is base
+      #
+      # @param request_options [SafetyKit::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [SafetyKit::Models::ContentCreateResponse]
+      #
+      # @see SafetyKit::Models::ContentCreateParams
+      def create(params)
+        parsed, options = SafetyKit::ContentCreateParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: "v1/content",
+          body: parsed,
+          model: SafetyKit::Models::ContentCreateResponse,
+          options: options
+        )
+      end
+
+      # @api private
+      #
+      # @param client [SafetyKit::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

data/lib/safety_kit/version.rb

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

data/lib/safety_kit.rb

@@ -62,6 +62,8 @@ require_relative "safety_kit/models/beta/event_create_params"
 require_relative "safety_kit/models/beta/event_create_response"
 require_relative "safety_kit/models/client_session_create_session_params"
 require_relative "safety_kit/models/client_session_create_session_response"
+require_relative "safety_kit/models/content_create_params"
+require_relative "safety_kit/models/content_create_response"
 require_relative "safety_kit/models/data_add_params"
 require_relative "safety_kit/models/data_add_response"
 require_relative "safety_kit/models/data_create_upload_url_params"
@@ -88,6 +90,7 @@ require_relative "safety_kit/resources/async"
 require_relative "safety_kit/resources/beta"
 require_relative "safety_kit/resources/beta/events"
 require_relative "safety_kit/resources/client_sessions"
+require_relative "safety_kit/resources/content"
 require_relative "safety_kit/resources/data"
 require_relative "safety_kit/resources/deletion_requests"
 require_relative "safety_kit/resources/streams"

data/rbi/safety_kit/client.rbi

@@ -37,6 +37,11 @@ module SafetyKit
     sig { returns(SafetyKit::Resources::Async) }
     attr_reader :async
 
+    # Classify user-authored text and images synchronously and receive a decision in
+    # the response.
+    sig { returns(SafetyKit::Resources::Content) }
+    attr_reader :content
+
     # Submit end-user deletion requests. Accepted requests are processed
     # asynchronously.
     sig { returns(SafetyKit::Resources::DeletionRequests) }

data/rbi/safety_kit/models/content_create_params.rbi

@@ -0,0 +1,95 @@
+# typed: strong
+
+module SafetyKit
+  module Models
+    class ContentCreateParams < SafetyKit::Internal::Type::BaseModel
+      extend SafetyKit::Internal::Type::RequestParameters::Converter
+      include SafetyKit::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(SafetyKit::ContentCreateParams, SafetyKit::Internal::AnyHash)
+        end
+
+      # Your stable identifier for the entity this content belongs to, such as a user,
+      # listing, or message thread.
+      sig { returns(String) }
+      attr_accessor :entity_id
+
+      # Your identifier for this content, matching the content_id sent on /v1/events.
+      # Prevents double-counting content submitted to both endpoints.
+      sig { returns(T.nilable(String)) }
+      attr_reader :content_id
+
+      sig { params(content_id: String).void }
+      attr_writer :content_id
+
+      # Images to classify, each as base64-encoded image bytes, raw or as a data URI. At
+      # most 4 images, 5MB each.
+      sig { returns(T.nilable(T::Array[String])) }
+      attr_reader :images
+
+      sig { params(images: T::Array[String]).void }
+      attr_writer :images
+
+      # Additional product context for this content. At most 8KB when serialized.
+      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
+
+      # User-authored text to classify. At most 20000 characters. Classification is
+      # based on the first 16,000 characters.
+      sig { returns(T.nilable(String)) }
+      attr_reader :text
+
+      sig { params(text: String).void }
+      attr_writer :text
+
+      sig do
+        params(
+          entity_id: String,
+          content_id: String,
+          images: T::Array[String],
+          metadata: T::Hash[Symbol, T.nilable(T.anything)],
+          text: String,
+          request_options: SafetyKit::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # Your stable identifier for the entity this content belongs to, such as a user,
+        # listing, or message thread.
+        entity_id:,
+        # Your identifier for this content, matching the content_id sent on /v1/events.
+        # Prevents double-counting content submitted to both endpoints.
+        content_id: nil,
+        # Images to classify, each as base64-encoded image bytes, raw or as a data URI. At
+        # most 4 images, 5MB each.
+        images: nil,
+        # Additional product context for this content. At most 8KB when serialized.
+        metadata: nil,
+        # User-authored text to classify. At most 20000 characters. Classification is
+        # based on the first 16,000 characters.
+        text: nil,
+        request_options: {}
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            entity_id: String,
+            content_id: String,
+            images: T::Array[String],
+            metadata: T::Hash[Symbol, T.nilable(T.anything)],
+            text: String,
+            request_options: SafetyKit::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/safety_kit/models/content_create_response.rbi

@@ -0,0 +1,272 @@
+# typed: strong
+
+module SafetyKit
+  module Models
+    class ContentCreateResponse < SafetyKit::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            SafetyKit::Models::ContentCreateResponse,
+            SafetyKit::Internal::AnyHash
+          )
+        end
+
+      # SafetyKit identifier for the classified content.
+      sig { returns(String) }
+      attr_accessor :content_id
+
+      # SafetyKit's decision for the submitted content: approve (no violation found),
+      # reject (violating), or review (needs human review).
+      sig do
+        returns(
+          SafetyKit::Models::ContentCreateResponse::Decision::TaggedSymbol
+        )
+      end
+      attr_accessor :decision
+
+      # The entity_id from the request.
+      sig { returns(String) }
+      attr_accessor :entity_id
+
+      # Escalation outcome: none (no escalation ran), completed (verdict reflected in
+      # decision), or timed_out (decision is a provisional review).
+      sig do
+        returns(
+          SafetyKit::Models::ContentCreateResponse::Escalation::TaggedSymbol
+        )
+      end
+      attr_accessor :escalation
+
+      # Whether SafetyKit mirrored the submitted content for later review.
+      sig { returns(T::Boolean) }
+      attr_accessor :mirrored
+
+      # Reference set matches found for the submitted content.
+      sig do
+        returns(
+          T::Array[SafetyKit::Models::ContentCreateResponse::ReferenceSetMatch]
+        )
+      end
+      attr_accessor :reference_set_matches
+
+      # Classifier scores produced for the submitted content.
+      sig { returns(T::Array[SafetyKit::Models::ContentCreateResponse::Score]) }
+      attr_accessor :scores
+
+      # Synchronous classification result for the submitted content.
+      sig do
+        params(
+          content_id: String,
+          decision:
+            SafetyKit::Models::ContentCreateResponse::Decision::OrSymbol,
+          entity_id: String,
+          escalation:
+            SafetyKit::Models::ContentCreateResponse::Escalation::OrSymbol,
+          mirrored: T::Boolean,
+          reference_set_matches:
+            T::Array[
+              SafetyKit::Models::ContentCreateResponse::ReferenceSetMatch::OrHash
+            ],
+          scores:
+            T::Array[SafetyKit::Models::ContentCreateResponse::Score::OrHash]
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # SafetyKit identifier for the classified content.
+        content_id:,
+        # SafetyKit's decision for the submitted content: approve (no violation found),
+        # reject (violating), or review (needs human review).
+        decision:,
+        # The entity_id from the request.
+        entity_id:,
+        # Escalation outcome: none (no escalation ran), completed (verdict reflected in
+        # decision), or timed_out (decision is a provisional review).
+        escalation:,
+        # Whether SafetyKit mirrored the submitted content for later review.
+        mirrored:,
+        # Reference set matches found for the submitted content.
+        reference_set_matches:,
+        # Classifier scores produced for the submitted content.
+        scores:
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            content_id: String,
+            decision:
+              SafetyKit::Models::ContentCreateResponse::Decision::TaggedSymbol,
+            entity_id: String,
+            escalation:
+              SafetyKit::Models::ContentCreateResponse::Escalation::TaggedSymbol,
+            mirrored: T::Boolean,
+            reference_set_matches:
+              T::Array[
+                SafetyKit::Models::ContentCreateResponse::ReferenceSetMatch
+              ],
+            scores: T::Array[SafetyKit::Models::ContentCreateResponse::Score]
+          }
+        )
+      end
+      def to_hash
+      end
+
+      # SafetyKit's decision for the submitted content: approve (no violation found),
+      # reject (violating), or review (needs human review).
+      module Decision
+        extend SafetyKit::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, SafetyKit::Models::ContentCreateResponse::Decision)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        APPROVE =
+          T.let(
+            :approve,
+            SafetyKit::Models::ContentCreateResponse::Decision::TaggedSymbol
+          )
+        REJECT =
+          T.let(
+            :reject,
+            SafetyKit::Models::ContentCreateResponse::Decision::TaggedSymbol
+          )
+        REVIEW =
+          T.let(
+            :review,
+            SafetyKit::Models::ContentCreateResponse::Decision::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              SafetyKit::Models::ContentCreateResponse::Decision::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
+
+      # Escalation outcome: none (no escalation ran), completed (verdict reflected in
+      # decision), or timed_out (decision is a provisional review).
+      module Escalation
+        extend SafetyKit::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, SafetyKit::Models::ContentCreateResponse::Escalation)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        NONE =
+          T.let(
+            :none,
+            SafetyKit::Models::ContentCreateResponse::Escalation::TaggedSymbol
+          )
+        COMPLETED =
+          T.let(
+            :completed,
+            SafetyKit::Models::ContentCreateResponse::Escalation::TaggedSymbol
+          )
+        TIMED_OUT =
+          T.let(
+            :timed_out,
+            SafetyKit::Models::ContentCreateResponse::Escalation::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              SafetyKit::Models::ContentCreateResponse::Escalation::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
+
+      class ReferenceSetMatch < SafetyKit::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              SafetyKit::Models::ContentCreateResponse::ReferenceSetMatch,
+              SafetyKit::Internal::AnyHash
+            )
+          end
+
+        # Identifier of the matched reference set.
+        sig { returns(String) }
+        attr_accessor :set_id
+
+        # Similarity between the submitted content and the matched reference set entry.
+        sig { returns(Float) }
+        attr_accessor :similarity
+
+        # Reference set match found for the submitted content.
+        sig do
+          params(set_id: String, similarity: Float).returns(T.attached_class)
+        end
+        def self.new(
+          # Identifier of the matched reference set.
+          set_id:,
+          # Similarity between the submitted content and the matched reference set entry.
+          similarity:
+        )
+        end
+
+        sig { override.returns({ set_id: String, similarity: Float }) }
+        def to_hash
+        end
+      end
+
+      class Score < SafetyKit::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              SafetyKit::Models::ContentCreateResponse::Score,
+              SafetyKit::Internal::AnyHash
+            )
+          end
+
+        # Identifier of the classifier that produced this score.
+        sig { returns(String) }
+        attr_accessor :classifier_id
+
+        # Classifier score between 0 and 1. Higher means more likely violating.
+        sig { returns(Float) }
+        attr_accessor :score
+
+        # Version of the classifier that produced this score.
+        sig { returns(String) }
+        attr_accessor :version
+
+        # Score produced by one classifier for the submitted content.
+        sig do
+          params(classifier_id: String, score: Float, version: String).returns(
+            T.attached_class
+          )
+        end
+        def self.new(
+          # Identifier of the classifier that produced this score.
+          classifier_id:,
+          # Classifier score between 0 and 1. Higher means more likely violating.
+          score:,
+          # Version of the classifier that produced this score.
+          version:
+        )
+        end
+
+        sig do
+          override.returns(
+            { classifier_id: String, score: Float, version: String }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/safety_kit/models.rbi

@@ -14,6 +14,8 @@ module SafetyKit
   ClientSessionCreateSessionParams =
     SafetyKit::Models::ClientSessionCreateSessionParams
 
+  ContentCreateParams = SafetyKit::Models::ContentCreateParams
+
   DataAddParams = SafetyKit::Models::DataAddParams
 
   DataCreateUploadURLParams = SafetyKit::Models::DataCreateUploadURLParams

data/rbi/safety_kit/resources/content.rbi

@@ -0,0 +1,46 @@
+# typed: strong
+
+module SafetyKit
+  module Resources
+    # Classify user-authored text and images synchronously and receive a decision in
+    # the response.
+    class Content
+      # Classify a piece of content synchronously. Send user-authored text, images, or
+      # both, and receive a decision (approve, reject, or review) with classifier scores
+      # and reference set matches in the response. Requests have a maximum size of 6MB.
+      sig do
+        params(
+          entity_id: String,
+          content_id: String,
+          images: T::Array[String],
+          metadata: T::Hash[Symbol, T.nilable(T.anything)],
+          text: String,
+          request_options: SafetyKit::RequestOptions::OrHash
+        ).returns(SafetyKit::Models::ContentCreateResponse)
+      end
+      def create(
+        # Your stable identifier for the entity this content belongs to, such as a user,
+        # listing, or message thread.
+        entity_id:,
+        # Your identifier for this content, matching the content_id sent on /v1/events.
+        # Prevents double-counting content submitted to both endpoints.
+        content_id: nil,
+        # Images to classify, each as base64-encoded image bytes, raw or as a data URI. At
+        # most 4 images, 5MB each.
+        images: nil,
+        # Additional product context for this content. At most 8KB when serialized.
+        metadata: nil,
+        # User-authored text to classify. At most 20000 characters. Classification is
+        # based on the first 16,000 characters.
+        text: nil,
+        request_options: {}
+      )
+      end
+
+      # @api private
+      sig { params(client: SafetyKit::Client).returns(T.attached_class) }
+      def self.new(client:)
+      end
+    end
+  end
+end

data/sig/safety_kit/client.rbs

@@ -20,6 +20,8 @@ module SafetyKit
 
     attr_reader async: SafetyKit::Resources::Async
 
+    attr_reader content: SafetyKit::Resources::Content
+
     attr_reader deletion_requests: SafetyKit::Resources::DeletionRequests
 
     attr_reader client_sessions: SafetyKit::Resources::ClientSessions

data/sig/safety_kit/models/content_create_params.rbs

@@ -0,0 +1,54 @@
+module SafetyKit
+  module Models
+    type content_create_params =
+      {
+        entity_id: String,
+        content_id: String,
+        images: ::Array[String],
+        metadata: ::Hash[Symbol, top?],
+        text: String
+      }
+      & SafetyKit::Internal::Type::request_parameters
+
+    class ContentCreateParams < SafetyKit::Internal::Type::BaseModel
+      extend SafetyKit::Internal::Type::RequestParameters::Converter
+      include SafetyKit::Internal::Type::RequestParameters
+
+      attr_accessor entity_id: String
+
+      attr_reader content_id: String?
+
+      def content_id=: (String) -> String
+
+      attr_reader images: ::Array[String]?
+
+      def images=: (::Array[String]) -> ::Array[String]
+
+      attr_reader metadata: ::Hash[Symbol, top?]?
+
+      def metadata=: (::Hash[Symbol, top?]) -> ::Hash[Symbol, top?]
+
+      attr_reader text: String?
+
+      def text=: (String) -> String
+
+      def initialize: (
+        entity_id: String,
+        ?content_id: String,
+        ?images: ::Array[String],
+        ?metadata: ::Hash[Symbol, top?],
+        ?text: String,
+        ?request_options: SafetyKit::request_opts
+      ) -> void
+
+      def to_hash: -> {
+        entity_id: String,
+        content_id: String,
+        images: ::Array[String],
+        metadata: ::Hash[Symbol, top?],
+        text: String,
+        request_options: SafetyKit::RequestOptions
+      }
+    end
+  end
+end

data/sig/safety_kit/models/content_create_response.rbs

@@ -0,0 +1,104 @@
+module SafetyKit
+  module Models
+    type content_create_response =
+      {
+        content_id: String,
+        decision: SafetyKit::Models::ContentCreateResponse::decision,
+        entity_id: String,
+        escalation: SafetyKit::Models::ContentCreateResponse::escalation,
+        mirrored: bool,
+        reference_set_matches: ::Array[SafetyKit::Models::ContentCreateResponse::ReferenceSetMatch],
+        scores: ::Array[SafetyKit::Models::ContentCreateResponse::Score]
+      }
+
+    class ContentCreateResponse < SafetyKit::Internal::Type::BaseModel
+      attr_accessor content_id: String
+
+      attr_accessor decision: SafetyKit::Models::ContentCreateResponse::decision
+
+      attr_accessor entity_id: String
+
+      attr_accessor escalation: SafetyKit::Models::ContentCreateResponse::escalation
+
+      attr_accessor mirrored: bool
+
+      attr_accessor reference_set_matches: ::Array[SafetyKit::Models::ContentCreateResponse::ReferenceSetMatch]
+
+      attr_accessor scores: ::Array[SafetyKit::Models::ContentCreateResponse::Score]
+
+      def initialize: (
+        content_id: String,
+        decision: SafetyKit::Models::ContentCreateResponse::decision,
+        entity_id: String,
+        escalation: SafetyKit::Models::ContentCreateResponse::escalation,
+        mirrored: bool,
+        reference_set_matches: ::Array[SafetyKit::Models::ContentCreateResponse::ReferenceSetMatch],
+        scores: ::Array[SafetyKit::Models::ContentCreateResponse::Score]
+      ) -> void
+
+      def to_hash: -> {
+        content_id: String,
+        decision: SafetyKit::Models::ContentCreateResponse::decision,
+        entity_id: String,
+        escalation: SafetyKit::Models::ContentCreateResponse::escalation,
+        mirrored: bool,
+        reference_set_matches: ::Array[SafetyKit::Models::ContentCreateResponse::ReferenceSetMatch],
+        scores: ::Array[SafetyKit::Models::ContentCreateResponse::Score]
+      }
+
+      type decision = :approve | :reject | :review
+
+      module Decision
+        extend SafetyKit::Internal::Type::Enum
+
+        APPROVE: :approve
+        REJECT: :reject
+        REVIEW: :review
+
+        def self?.values: -> ::Array[SafetyKit::Models::ContentCreateResponse::decision]
+      end
+
+      type escalation = :none | :completed | :timed_out
+
+      module Escalation
+        extend SafetyKit::Internal::Type::Enum
+
+        NONE: :none
+        COMPLETED: :completed
+        TIMED_OUT: :timed_out
+
+        def self?.values: -> ::Array[SafetyKit::Models::ContentCreateResponse::escalation]
+      end
+
+      type reference_set_match = { set_id: String, similarity: Float }
+
+      class ReferenceSetMatch < SafetyKit::Internal::Type::BaseModel
+        attr_accessor set_id: String
+
+        attr_accessor similarity: Float
+
+        def initialize: (set_id: String, similarity: Float) -> void
+
+        def to_hash: -> { set_id: String, similarity: Float }
+      end
+
+      type score = { classifier_id: String, score: Float, version: String }
+
+      class Score < SafetyKit::Internal::Type::BaseModel
+        attr_accessor classifier_id: String
+
+        attr_accessor score: Float
+
+        attr_accessor version: String
+
+        def initialize: (
+          classifier_id: String,
+          score: Float,
+          version: String
+        ) -> void
+
+        def to_hash: -> { classifier_id: String, score: Float, version: String }
+      end
+    end
+  end
+end

data/sig/safety_kit/models.rbs

@@ -9,6 +9,8 @@ module SafetyKit
 
   class ClientSessionCreateSessionParams = SafetyKit::Models::ClientSessionCreateSessionParams
 
+  class ContentCreateParams = SafetyKit::Models::ContentCreateParams
+
   class DataAddParams = SafetyKit::Models::DataAddParams
 
   class DataCreateUploadURLParams = SafetyKit::Models::DataCreateUploadURLParams

data/sig/safety_kit/resources/content.rbs

@@ -0,0 +1,16 @@
+module SafetyKit
+  module Resources
+    class Content
+      def create: (
+        entity_id: String,
+        ?content_id: String,
+        ?images: ::Array[String],
+        ?metadata: ::Hash[Symbol, top?],
+        ?text: String,
+        ?request_options: SafetyKit::request_opts
+      ) -> SafetyKit::Models::ContentCreateResponse
+
+      def initialize: (client: SafetyKit::Client) -> void
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: safetykit
 version: !ruby/object:Gem::Version
-  version: 0.50.0
+  version: 0.52.0
 platform: ruby
 authors:
 - Safetykit
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-08-01 00:00:00.000000000 Z
+date: 2026-08-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi
@@ -79,6 +79,8 @@ files:
 - lib/safety_kit/models/beta/event_create_response.rb
 - lib/safety_kit/models/client_session_create_session_params.rb
 - lib/safety_kit/models/client_session_create_session_response.rb
+- lib/safety_kit/models/content_create_params.rb
+- lib/safety_kit/models/content_create_response.rb
 - lib/safety_kit/models/data_add_params.rb
 - lib/safety_kit/models/data_add_response.rb
 - lib/safety_kit/models/data_create_upload_url_params.rb
@@ -105,6 +107,7 @@ files:
 - lib/safety_kit/resources/beta.rb
 - lib/safety_kit/resources/beta/events.rb
 - lib/safety_kit/resources/client_sessions.rb
+- lib/safety_kit/resources/content.rb
 - lib/safety_kit/resources/data.rb
 - lib/safety_kit/resources/deletion_requests.rb
 - lib/safety_kit/resources/streams.rb
@@ -139,6 +142,8 @@ files:
 - rbi/safety_kit/models/beta/event_create_response.rbi
 - rbi/safety_kit/models/client_session_create_session_params.rbi
 - rbi/safety_kit/models/client_session_create_session_response.rbi
+- rbi/safety_kit/models/content_create_params.rbi
+- rbi/safety_kit/models/content_create_response.rbi
 - rbi/safety_kit/models/data_add_params.rbi
 - rbi/safety_kit/models/data_add_response.rbi
 - rbi/safety_kit/models/data_create_upload_url_params.rbi
@@ -165,6 +170,7 @@ files:
 - rbi/safety_kit/resources/beta.rbi
 - rbi/safety_kit/resources/beta/events.rbi
 - rbi/safety_kit/resources/client_sessions.rbi
+- rbi/safety_kit/resources/content.rbi
 - rbi/safety_kit/resources/data.rbi
 - rbi/safety_kit/resources/deletion_requests.rbi
 - rbi/safety_kit/resources/streams.rbi
@@ -198,6 +204,8 @@ files:
 - sig/safety_kit/models/beta/event_create_response.rbs
 - sig/safety_kit/models/client_session_create_session_params.rbs
 - sig/safety_kit/models/client_session_create_session_response.rbs
+- sig/safety_kit/models/content_create_params.rbs
+- sig/safety_kit/models/content_create_response.rbs
 - sig/safety_kit/models/data_add_params.rbs
 - sig/safety_kit/models/data_add_response.rbs
 - sig/safety_kit/models/data_create_upload_url_params.rbs
@@ -224,6 +232,7 @@ files:
 - sig/safety_kit/resources/beta.rbs
 - sig/safety_kit/resources/beta/events.rbs
 - sig/safety_kit/resources/client_sessions.rbs
+- sig/safety_kit/resources/content.rbs
 - sig/safety_kit/resources/data.rbs
 - sig/safety_kit/resources/deletion_requests.rbs
 - sig/safety_kit/resources/streams.rbs