safetykit 0.52.0 → 0.53.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fb740cd06fd2147d66523afd833977860625eba2fa2b3b85dba5933a46f68a74
-  data.tar.gz: 49974de3af4a1b8188a16cd72999a6eb822338e4f2cb5b5ee80739885f550aad
+  metadata.gz: e99118dc813839214ef54180d8c8b7fd0528ddeb49f48d2eecde4ec540bbaa41
+  data.tar.gz: '08c93665f10cc3be1ce9a44781e2c60b6ede81d25fbec916f6bd29be2ba62558'
 SHA512:
-  metadata.gz: bd4c8bf187f42c1ddbff83a393afd6c3e177414a1c37f62b6d1847c8457cc2de4d570d5941c6a81f13701006cd77c80f62b7919bcc26459418b6f9ca5b572fe8
-  data.tar.gz: 9bd4562815b061c8d5995cf75aa02752726f66e55cb2d8ecd5bd8893f434bd0470e403cef886e004214f20c04b35565096d731b539b27285444364e36d042989
+  metadata.gz: 7db211c300da39bc4e7c0dd74ca7220bfc38aa23df5c597a054ab72cd4156859aa583025ff7292c02121c78c7743d27912b72374a7a70ae0f16ab21bef5953ae
+  data.tar.gz: 2569223e2d2779daab8a6a364fcde41473e1dfc7af8cb345b790eb590f74e02b47b79f03e46ee42f63468fe6718693292962f8f2611aede4d82ea86024151c84

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.53.0 (2026-08-06)
+
+Full Changelog: [v0.52.0...v0.53.0](https://github.com/GetSafetyKit/safetykit-ruby/compare/v0.52.0...v0.53.0)
+
+### Features
+
+* **api:** api update ([4c74263](https://github.com/GetSafetyKit/safetykit-ruby/commit/4c74263a51e3176b1ff3660c1b5ac14d0dcd3559))
+
 ## 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)

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.52.0"
+gem "safetykit", "~> 0.53.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/safety_kit/models/content_create_params.rb

@@ -7,12 +7,11 @@ module SafetyKit
       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.
+      # @!attribute user_id
+      #   Your stable identifier for the user this content belongs to.
       #
       #   @return [String]
-      required :entity_id, String
+      required :user_id, String
 
       # @!attribute content_id
       #   Your identifier for this content, matching the content_id sent on /v1/events.
@@ -23,7 +22,7 @@ module SafetyKit
 
       # @!attribute images
       #   Images to classify, each as base64-encoded image bytes, raw or as a data URI. At
-      #   most 4 images, 5MB each.
+      #   most 20 images, 5MB each.
       #
       #   @return [Array<String>, nil]
       optional :images, SafetyKit::Internal::Type::ArrayOf[String]
@@ -35,17 +34,16 @@ module SafetyKit
       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.
+      #   User-authored text to classify. At most 16000 characters.
       #
       #   @return [String, nil]
       optional :text, String
 
-      # @!method initialize(entity_id:, content_id: nil, images: nil, metadata: nil, text: nil, request_options: {})
+      # @!method initialize(user_id:, content_id: nil, images: nil, metadata: nil, text: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {SafetyKit::Models::ContentCreateParams} for more details.
       #
-      #   @param entity_id [String] Your stable identifier for the entity this content belongs to, such as a user, l
+      #   @param user_id [String] Your stable identifier for the user this content belongs to.
       #
       #   @param content_id [String] Your identifier for this content, matching the content_id sent on /v1/events. Pr
       #
@@ -53,7 +51,7 @@ module SafetyKit
       #
       #   @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 text [String] User-authored text to classify. At most 16000 characters.
       #
       #   @param request_options [SafetyKit::RequestOptions, Hash{Symbol=>Object}]
     end

data/lib/safety_kit/models/content_create_response.rb

@@ -11,30 +11,18 @@ module SafetyKit
       required :content_id, String
 
       # @!attribute decision
-      #   SafetyKit's decision for the submitted content: approve (no violation found),
-      #   reject (violating), or review (needs human review).
+      #   Overall decision: match if any policy matched, review if any policy needs
+      #   review, not_match otherwise.
       #
       #   @return [Symbol, SafetyKit::Models::ContentCreateResponse::Decision]
       required :decision, enum: -> { SafetyKit::Models::ContentCreateResponse::Decision }
 
-      # @!attribute entity_id
-      #   The entity_id from the request.
+      # @!attribute policies
+      #   Per-policy results for the submitted content.
       #
-      #   @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
+      #   @return [Array<SafetyKit::Models::ContentCreateResponse::Policy>]
+      required :policies,
+               -> { SafetyKit::Internal::Type::ArrayOf[SafetyKit::Models::ContentCreateResponse::Policy] }
 
       # @!attribute reference_set_matches
       #   Reference set matches found for the submitted content.
@@ -43,14 +31,13 @@ module SafetyKit
       required :reference_set_matches,
                -> { SafetyKit::Internal::Type::ArrayOf[SafetyKit::Models::ContentCreateResponse::ReferenceSetMatch] }
 
-      # @!attribute scores
-      #   Classifier scores produced for the submitted content.
+      # @!attribute user_id
+      #   The user_id from the request.
       #
-      #   @return [Array<SafetyKit::Models::ContentCreateResponse::Score>]
-      required :scores,
-               -> { SafetyKit::Internal::Type::ArrayOf[SafetyKit::Models::ContentCreateResponse::Score] }
+      #   @return [String]
+      required :user_id, String
 
-      # @!method initialize(content_id:, decision:, entity_id:, escalation:, mirrored:, reference_set_matches:, scores:)
+      # @!method initialize(content_id:, decision:, policies:, reference_set_matches:, user_id:)
       #   Some parameter documentations has been truncated, see
       #   {SafetyKit::Models::ContentCreateResponse} for more details.
       #
@@ -58,46 +45,107 @@ module SafetyKit
       #
       #   @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 decision [Symbol, SafetyKit::Models::ContentCreateResponse::Decision] Overall decision: match if any policy matched, review if any policy needs review
       #
-      #   @param mirrored [Boolean] Whether SafetyKit mirrored the submitted content for later review.
+      #   @param policies [Array<SafetyKit::Models::ContentCreateResponse::Policy>] Per-policy results for the submitted content.
       #
       #   @param reference_set_matches [Array<SafetyKit::Models::ContentCreateResponse::ReferenceSetMatch>] Reference set matches found for the submitted content.
       #
-      #   @param scores [Array<SafetyKit::Models::ContentCreateResponse::Score>] Classifier scores produced for the submitted content.
+      #   @param user_id [String] The user_id from the request.
 
-      # SafetyKit's decision for the submitted content: approve (no violation found),
-      # reject (violating), or review (needs human review).
+      # Overall decision: match if any policy matched, review if any policy needs
+      # review, not_match otherwise.
       #
       # @see SafetyKit::Models::ContentCreateResponse#decision
       module Decision
         extend SafetyKit::Internal::Type::Enum
 
-        APPROVE = :approve
-        REJECT = :reject
+        MATCH = :match
+        NOT_MATCH = :not_match
         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
+      class Policy < SafetyKit::Internal::Type::BaseModel
+        # @!attribute decision
+        #   Decision for the submitted content: match (violates the policy), not_match (does
+        #   not violate), or review (needs human review).
+        #
+        #   @return [Symbol, SafetyKit::Models::ContentCreateResponse::Policy::Decision]
+        required :decision, enum: -> { SafetyKit::Models::ContentCreateResponse::Policy::Decision }
 
-        NONE = :none
-        COMPLETED = :completed
-        TIMED_OUT = :timed_out
+        # @!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::Policy::Escalation]
+        required :escalation, enum: -> { SafetyKit::Models::ContentCreateResponse::Policy::Escalation }
 
-        # @!method self.values
-        #   @return [Array<Symbol>]
+        # @!attribute policy_id
+        #   Identifier of the policy.
+        #
+        #   @return [String]
+        required :policy_id, String
+
+        # @!attribute score
+        #   Policy score between 0 and 1. Higher means more likely violating.
+        #
+        #   @return [Float]
+        required :score, Float
+
+        # @!attribute version
+        #   Version of the policy.
+        #
+        #   @return [String]
+        required :version, String
+
+        # @!method initialize(decision:, escalation:, policy_id:, score:, version:)
+        #   Some parameter documentations has been truncated, see
+        #   {SafetyKit::Models::ContentCreateResponse::Policy} for more details.
+        #
+        #   Result for one policy evaluated against the submitted content.
+        #
+        #   @param decision [Symbol, SafetyKit::Models::ContentCreateResponse::Policy::Decision] Decision for the submitted content: match (violates the policy), not_match (does
+        #
+        #   @param escalation [Symbol, SafetyKit::Models::ContentCreateResponse::Policy::Escalation] Escalation outcome: none (no escalation ran), completed (verdict reflected in de
+        #
+        #   @param policy_id [String] Identifier of the policy.
+        #
+        #   @param score [Float] Policy score between 0 and 1. Higher means more likely violating.
+        #
+        #   @param version [String] Version of the policy.
+
+        # Decision for the submitted content: match (violates the policy), not_match (does
+        # not violate), or review (needs human review).
+        #
+        # @see SafetyKit::Models::ContentCreateResponse::Policy#decision
+        module Decision
+          extend SafetyKit::Internal::Type::Enum
+
+          MATCH = :match
+          NOT_MATCH = :not_match
+          REVIEW = :review
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
+        # Escalation outcome: none (no escalation ran), completed (verdict reflected in
+        # decision), or timed_out (decision is a provisional review).
+        #
+        # @see SafetyKit::Models::ContentCreateResponse::Policy#escalation
+        module Escalation
+          extend SafetyKit::Internal::Type::Enum
+
+          NONE = :none
+          COMPLETED = :completed
+          TIMED_OUT = :timed_out
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
       end
 
       class ReferenceSetMatch < SafetyKit::Internal::Type::BaseModel
@@ -120,35 +168,6 @@ module SafetyKit
         #
         #   @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/resources/content.rb

@@ -9,12 +9,12 @@ module SafetyKit
       # {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.
+      # both, and receive per-policy results with an overall decision (match, not_match,
+      # or review) 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: {})
+      # @overload create(user_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 user_id [String] Your stable identifier for the user this content belongs to.
       #
       # @param content_id [String] Your identifier for this content, matching the content_id sent on /v1/events. Pr
       #
@@ -22,7 +22,7 @@ module SafetyKit
       #
       # @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 text [String] User-authored text to classify. At most 16000 characters.
       #
       # @param request_options [SafetyKit::RequestOptions, Hash{Symbol=>Object}, nil]
       #

data/lib/safety_kit/version.rb

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

data/rbi/safety_kit/models/content_create_params.rbi

@@ -11,10 +11,9 @@ module SafetyKit
           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.
+      # Your stable identifier for the user this content belongs to.
       sig { returns(String) }
-      attr_accessor :entity_id
+      attr_accessor :user_id
 
       # Your identifier for this content, matching the content_id sent on /v1/events.
       # Prevents double-counting content submitted to both endpoints.
@@ -25,7 +24,7 @@ module SafetyKit
       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.
+      # most 20 images, 5MB each.
       sig { returns(T.nilable(T::Array[String])) }
       attr_reader :images
 
@@ -39,8 +38,7 @@ module SafetyKit
       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.
+      # User-authored text to classify. At most 16000 characters.
       sig { returns(T.nilable(String)) }
       attr_reader :text
 
@@ -49,7 +47,7 @@ module SafetyKit
 
       sig do
         params(
-          entity_id: String,
+          user_id: String,
           content_id: String,
           images: T::Array[String],
           metadata: T::Hash[Symbol, T.nilable(T.anything)],
@@ -58,19 +56,17 @@ module SafetyKit
         ).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 stable identifier for the user this content belongs to.
+        user_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.
+        # most 20 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.
+        # User-authored text to classify. At most 16000 characters.
         text: nil,
         request_options: {}
       )
@@ -79,7 +75,7 @@ module SafetyKit
       sig do
         override.returns(
           {
-            entity_id: String,
+            user_id: String,
             content_id: String,
             images: T::Array[String],
             metadata: T::Hash[Symbol, T.nilable(T.anything)],

data/rbi/safety_kit/models/content_create_response.rbi

@@ -15,8 +15,8 @@ module SafetyKit
       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).
+      # Overall decision: match if any policy matched, review if any policy needs
+      # review, not_match otherwise.
       sig do
         returns(
           SafetyKit::Models::ContentCreateResponse::Decision::TaggedSymbol
@@ -24,22 +24,11 @@ module SafetyKit
       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).
+      # Per-policy results for the submitted content.
       sig do
-        returns(
-          SafetyKit::Models::ContentCreateResponse::Escalation::TaggedSymbol
-        )
+        returns(T::Array[SafetyKit::Models::ContentCreateResponse::Policy])
       end
-      attr_accessor :escalation
-
-      # Whether SafetyKit mirrored the submitted content for later review.
-      sig { returns(T::Boolean) }
-      attr_accessor :mirrored
+      attr_accessor :policies
 
       # Reference set matches found for the submitted content.
       sig do
@@ -49,9 +38,9 @@ module SafetyKit
       end
       attr_accessor :reference_set_matches
 
-      # Classifier scores produced for the submitted content.
-      sig { returns(T::Array[SafetyKit::Models::ContentCreateResponse::Score]) }
-      attr_accessor :scores
+      # The user_id from the request.
+      sig { returns(String) }
+      attr_accessor :user_id
 
       # Synchronous classification result for the submitted content.
       sig do
@@ -59,35 +48,27 @@ module SafetyKit
           content_id: String,
           decision:
             SafetyKit::Models::ContentCreateResponse::Decision::OrSymbol,
-          entity_id: String,
-          escalation:
-            SafetyKit::Models::ContentCreateResponse::Escalation::OrSymbol,
-          mirrored: T::Boolean,
+          policies:
+            T::Array[SafetyKit::Models::ContentCreateResponse::Policy::OrHash],
           reference_set_matches:
             T::Array[
               SafetyKit::Models::ContentCreateResponse::ReferenceSetMatch::OrHash
             ],
-          scores:
-            T::Array[SafetyKit::Models::ContentCreateResponse::Score::OrHash]
+          user_id: String
         ).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).
+        # Overall decision: match if any policy matched, review if any policy needs
+        # review, not_match otherwise.
         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:,
+        # Per-policy results for the submitted content.
+        policies:,
         # Reference set matches found for the submitted content.
         reference_set_matches:,
-        # Classifier scores produced for the submitted content.
-        scores:
+        # The user_id from the request.
+        user_id:
       )
       end
 
@@ -97,23 +78,21 @@ module SafetyKit
             content_id: String,
             decision:
               SafetyKit::Models::ContentCreateResponse::Decision::TaggedSymbol,
-            entity_id: String,
-            escalation:
-              SafetyKit::Models::ContentCreateResponse::Escalation::TaggedSymbol,
-            mirrored: T::Boolean,
+            policies:
+              T::Array[SafetyKit::Models::ContentCreateResponse::Policy],
             reference_set_matches:
               T::Array[
                 SafetyKit::Models::ContentCreateResponse::ReferenceSetMatch
               ],
-            scores: T::Array[SafetyKit::Models::ContentCreateResponse::Score]
+            user_id: String
           }
         )
       end
       def to_hash
       end
 
-      # SafetyKit's decision for the submitted content: approve (no violation found),
-      # reject (violating), or review (needs human review).
+      # Overall decision: match if any policy matched, review if any policy needs
+      # review, not_match otherwise.
       module Decision
         extend SafetyKit::Internal::Type::Enum
 
@@ -123,14 +102,14 @@ module SafetyKit
           end
         OrSymbol = T.type_alias { T.any(Symbol, String) }
 
-        APPROVE =
+        MATCH =
           T.let(
-            :approve,
+            :match,
             SafetyKit::Models::ContentCreateResponse::Decision::TaggedSymbol
           )
-        REJECT =
+        NOT_MATCH =
           T.let(
-            :reject,
+            :not_match,
             SafetyKit::Models::ContentCreateResponse::Decision::TaggedSymbol
           )
         REVIEW =
@@ -150,41 +129,169 @@ module SafetyKit
         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 =
+      class Policy < SafetyKit::Internal::Type::BaseModel
+        OrHash =
           T.type_alias do
-            T.all(Symbol, SafetyKit::Models::ContentCreateResponse::Escalation)
+            T.any(
+              SafetyKit::Models::ContentCreateResponse::Policy,
+              SafetyKit::Internal::AnyHash
+            )
           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
+        # Decision for the submitted content: match (violates the policy), not_match (does
+        # not violate), or review (needs human review).
+        sig do
+          returns(
+            SafetyKit::Models::ContentCreateResponse::Policy::Decision::TaggedSymbol
           )
-        TIMED_OUT =
-          T.let(
-            :timed_out,
-            SafetyKit::Models::ContentCreateResponse::Escalation::TaggedSymbol
+        end
+        attr_accessor :decision
+
+        # 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::Policy::Escalation::TaggedSymbol
           )
+        end
+        attr_accessor :escalation
+
+        # Identifier of the policy.
+        sig { returns(String) }
+        attr_accessor :policy_id
+
+        # Policy score between 0 and 1. Higher means more likely violating.
+        sig { returns(Float) }
+        attr_accessor :score
+
+        # Version of the policy.
+        sig { returns(String) }
+        attr_accessor :version
+
+        # Result for one policy evaluated against the submitted content.
+        sig do
+          params(
+            decision:
+              SafetyKit::Models::ContentCreateResponse::Policy::Decision::OrSymbol,
+            escalation:
+              SafetyKit::Models::ContentCreateResponse::Policy::Escalation::OrSymbol,
+            policy_id: String,
+            score: Float,
+            version: String
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Decision for the submitted content: match (violates the policy), not_match (does
+          # not violate), or review (needs human review).
+          decision:,
+          # Escalation outcome: none (no escalation ran), completed (verdict reflected in
+          # decision), or timed_out (decision is a provisional review).
+          escalation:,
+          # Identifier of the policy.
+          policy_id:,
+          # Policy score between 0 and 1. Higher means more likely violating.
+          score:,
+          # Version of the policy.
+          version:
+        )
+        end
 
         sig do
           override.returns(
-            T::Array[
-              SafetyKit::Models::ContentCreateResponse::Escalation::TaggedSymbol
-            ]
+            {
+              decision:
+                SafetyKit::Models::ContentCreateResponse::Policy::Decision::TaggedSymbol,
+              escalation:
+                SafetyKit::Models::ContentCreateResponse::Policy::Escalation::TaggedSymbol,
+              policy_id: String,
+              score: Float,
+              version: String
+            }
           )
         end
-        def self.values
+        def to_hash
+        end
+
+        # Decision for the submitted content: match (violates the policy), not_match (does
+        # not violate), or review (needs human review).
+        module Decision
+          extend SafetyKit::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(
+                Symbol,
+                SafetyKit::Models::ContentCreateResponse::Policy::Decision
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          MATCH =
+            T.let(
+              :match,
+              SafetyKit::Models::ContentCreateResponse::Policy::Decision::TaggedSymbol
+            )
+          NOT_MATCH =
+            T.let(
+              :not_match,
+              SafetyKit::Models::ContentCreateResponse::Policy::Decision::TaggedSymbol
+            )
+          REVIEW =
+            T.let(
+              :review,
+              SafetyKit::Models::ContentCreateResponse::Policy::Decision::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                SafetyKit::Models::ContentCreateResponse::Policy::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::Policy::Escalation
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          NONE =
+            T.let(
+              :none,
+              SafetyKit::Models::ContentCreateResponse::Policy::Escalation::TaggedSymbol
+            )
+          COMPLETED =
+            T.let(
+              :completed,
+              SafetyKit::Models::ContentCreateResponse::Policy::Escalation::TaggedSymbol
+            )
+          TIMED_OUT =
+            T.let(
+              :timed_out,
+              SafetyKit::Models::ContentCreateResponse::Policy::Escalation::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                SafetyKit::Models::ContentCreateResponse::Policy::Escalation::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
         end
       end
 
@@ -221,52 +328,6 @@ module SafetyKit
         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/resources/content.rbi

@@ -6,11 +6,11 @@ module SafetyKit
     # 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.
+      # both, and receive per-policy results with an overall decision (match, not_match,
+      # or review) in the response. Requests have a maximum size of 6MB.
       sig do
         params(
-          entity_id: String,
+          user_id: String,
           content_id: String,
           images: T::Array[String],
           metadata: T::Hash[Symbol, T.nilable(T.anything)],
@@ -19,19 +19,17 @@ module SafetyKit
         ).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 stable identifier for the user this content belongs to.
+        user_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.
+        # most 20 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.
+        # User-authored text to classify. At most 16000 characters.
         text: nil,
         request_options: {}
       )

data/sig/safety_kit/models/content_create_params.rbs

@@ -2,7 +2,7 @@ module SafetyKit
   module Models
     type content_create_params =
       {
-        entity_id: String,
+        user_id: String,
         content_id: String,
         images: ::Array[String],
         metadata: ::Hash[Symbol, top?],
@@ -14,7 +14,7 @@ module SafetyKit
       extend SafetyKit::Internal::Type::RequestParameters::Converter
       include SafetyKit::Internal::Type::RequestParameters
 
-      attr_accessor entity_id: String
+      attr_accessor user_id: String
 
       attr_reader content_id: String?
 
@@ -33,7 +33,7 @@ module SafetyKit
       def text=: (String) -> String
 
       def initialize: (
-        entity_id: String,
+        user_id: String,
         ?content_id: String,
         ?images: ::Array[String],
         ?metadata: ::Hash[Symbol, top?],
@@ -42,7 +42,7 @@ module SafetyKit
       ) -> void
 
       def to_hash: -> {
-        entity_id: String,
+        user_id: String,
         content_id: String,
         images: ::Array[String],
         metadata: ::Hash[Symbol, top?],

data/sig/safety_kit/models/content_create_response.rbs

@@ -4,11 +4,9 @@ module SafetyKit
       {
         content_id: String,
         decision: SafetyKit::Models::ContentCreateResponse::decision,
-        entity_id: String,
-        escalation: SafetyKit::Models::ContentCreateResponse::escalation,
-        mirrored: bool,
+        policies: ::Array[SafetyKit::Models::ContentCreateResponse::Policy],
         reference_set_matches: ::Array[SafetyKit::Models::ContentCreateResponse::ReferenceSetMatch],
-        scores: ::Array[SafetyKit::Models::ContentCreateResponse::Score]
+        user_id: String
       }
 
     class ContentCreateResponse < SafetyKit::Internal::Type::BaseModel
@@ -16,58 +14,99 @@ module SafetyKit
 
       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 policies: ::Array[SafetyKit::Models::ContentCreateResponse::Policy]
 
       attr_accessor reference_set_matches: ::Array[SafetyKit::Models::ContentCreateResponse::ReferenceSetMatch]
 
-      attr_accessor scores: ::Array[SafetyKit::Models::ContentCreateResponse::Score]
+      attr_accessor user_id: String
 
       def initialize: (
         content_id: String,
         decision: SafetyKit::Models::ContentCreateResponse::decision,
-        entity_id: String,
-        escalation: SafetyKit::Models::ContentCreateResponse::escalation,
-        mirrored: bool,
+        policies: ::Array[SafetyKit::Models::ContentCreateResponse::Policy],
         reference_set_matches: ::Array[SafetyKit::Models::ContentCreateResponse::ReferenceSetMatch],
-        scores: ::Array[SafetyKit::Models::ContentCreateResponse::Score]
+        user_id: String
       ) -> void
 
       def to_hash: -> {
         content_id: String,
         decision: SafetyKit::Models::ContentCreateResponse::decision,
-        entity_id: String,
-        escalation: SafetyKit::Models::ContentCreateResponse::escalation,
-        mirrored: bool,
+        policies: ::Array[SafetyKit::Models::ContentCreateResponse::Policy],
         reference_set_matches: ::Array[SafetyKit::Models::ContentCreateResponse::ReferenceSetMatch],
-        scores: ::Array[SafetyKit::Models::ContentCreateResponse::Score]
+        user_id: String
       }
 
-      type decision = :approve | :reject | :review
+      type decision = :match | :not_match | :review
 
       module Decision
         extend SafetyKit::Internal::Type::Enum
 
-        APPROVE: :approve
-        REJECT: :reject
+        MATCH: :match
+        NOT_MATCH: :not_match
         REVIEW: :review
 
         def self?.values: -> ::Array[SafetyKit::Models::ContentCreateResponse::decision]
       end
 
-      type escalation = :none | :completed | :timed_out
+      type policy =
+        {
+          decision: SafetyKit::Models::ContentCreateResponse::Policy::decision,
+          escalation: SafetyKit::Models::ContentCreateResponse::Policy::escalation,
+          policy_id: String,
+          score: Float,
+          version: String
+        }
 
-      module Escalation
-        extend SafetyKit::Internal::Type::Enum
+      class Policy < SafetyKit::Internal::Type::BaseModel
+        attr_accessor decision: SafetyKit::Models::ContentCreateResponse::Policy::decision
+
+        attr_accessor escalation: SafetyKit::Models::ContentCreateResponse::Policy::escalation
+
+        attr_accessor policy_id: String
+
+        attr_accessor score: Float
+
+        attr_accessor version: String
+
+        def initialize: (
+          decision: SafetyKit::Models::ContentCreateResponse::Policy::decision,
+          escalation: SafetyKit::Models::ContentCreateResponse::Policy::escalation,
+          policy_id: String,
+          score: Float,
+          version: String
+        ) -> void
+
+        def to_hash: -> {
+          decision: SafetyKit::Models::ContentCreateResponse::Policy::decision,
+          escalation: SafetyKit::Models::ContentCreateResponse::Policy::escalation,
+          policy_id: String,
+          score: Float,
+          version: String
+        }
 
-        NONE: :none
-        COMPLETED: :completed
-        TIMED_OUT: :timed_out
+        type decision = :match | :not_match | :review
 
-        def self?.values: -> ::Array[SafetyKit::Models::ContentCreateResponse::escalation]
+        module Decision
+          extend SafetyKit::Internal::Type::Enum
+
+          MATCH: :match
+          NOT_MATCH: :not_match
+          REVIEW: :review
+
+          def self?.values: -> ::Array[SafetyKit::Models::ContentCreateResponse::Policy::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::Policy::escalation]
+        end
       end
 
       type reference_set_match = { set_id: String, similarity: Float }
@@ -81,24 +120,6 @@ module SafetyKit
 
         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/resources/content.rbs

@@ -2,7 +2,7 @@ module SafetyKit
   module Resources
     class Content
       def create: (
-        entity_id: String,
+        user_id: String,
         ?content_id: String,
         ?images: ::Array[String],
         ?metadata: ::Hash[Symbol, top?],

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: safetykit
 version: !ruby/object:Gem::Version
-  version: 0.52.0
+  version: 0.53.0
 platform: ruby
 authors:
 - Safetykit
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-08-05 00:00:00.000000000 Z
+date: 2026-08-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi