safetykit 0.56.0 → 0.58.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e4f14e3ad89b25b2fdd5f3cc9683b7397a4a71cda7d7f31a9a12bf4bdd081333
-  data.tar.gz: eedcb639f3053397b70fddff1853c49d5313e0146d9139a44dba5129d1863b75
+  metadata.gz: 9283c72242f9da00698a358a99a018701a042b3de8b402a9efc5aa998b7cb145
+  data.tar.gz: 4f0e511b6540d3b7c05d9f2ab09cc90aedd779c0c5a39c8c3f10c6334eae4730
 SHA512:
-  metadata.gz: 1e7d88a65263dd63d77dd2fcdc39510fec92b32fb20ace949182a02a55cfb4ed34771439fb6e62200bbfb3aafb1ea546c37ee903a18f0fd7a94531f261a1678c
-  data.tar.gz: 710b42dff5bb08f06668078f5a73756b7dd705c4d3e9bf05d3f5d98c9ddab13e34332ae5e06e01936d8f256e7ad626b24be3a0d6276c41155b7a0dc9645881df
+  metadata.gz: 754d578687d2e96ae89e407fe3d5edd4bcecc658fefc899d382d4da7b52c0703e8624539ce59a66733595a17810454a150e25b6c39b69812edf350795a34d241
+  data.tar.gz: fd0eb6f82659e7f5b55e0a0f0380cafae7e85aef310776a9b37fa6236f354037fabf2579415f5f45356b977b193b3a71cf9d6298b3e1147454917b03216f3fa2

data/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 0.58.0 (2026-08-11)
+
+Full Changelog: [v0.57.0...v0.58.0](https://github.com/GetSafetyKit/safetykit-ruby/compare/v0.57.0...v0.58.0)
+
+### Features
+
+* **api:** api update ([6e357b2](https://github.com/GetSafetyKit/safetykit-ruby/commit/6e357b2845a8f97084b348cb2bf7dccdb97c5d43))
+
+## 0.57.0 (2026-08-11)
+
+Full Changelog: [v0.56.0...v0.57.0](https://github.com/GetSafetyKit/safetykit-ruby/compare/v0.56.0...v0.57.0)
+
+### Features
+
+* **api:** api update ([85b1dd1](https://github.com/GetSafetyKit/safetykit-ruby/commit/85b1dd123b3cd30db6824146d29bffe4ef5e2f57))
+
 ## 0.56.0 (2026-08-07)
 
 Full Changelog: [v0.55.0...v0.56.0](https://github.com/GetSafetyKit/safetykit-ruby/compare/v0.55.0...v0.56.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.56.0"
+gem "safetykit", "~> 0.58.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/safety_kit/models/content_create_params.rb

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

data/lib/safety_kit/models/content_create_response.rb

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

data/lib/safety_kit/resources/content.rb

@@ -8,26 +8,26 @@ module SafetyKit
       # 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 per-policy results in the response. Requests have a maximum
-      # size of 6MB.
+      # 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.
       #
       # 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. 503
       # when classification is temporarily unavailable, in which case the request was
       # not processed and is safe to retry.
       #
-      # @overload create(user_id:, content_id: nil, images: nil, metadata: nil, text: nil, request_options: {})
+      # @overload create(content:, user_id:, content_id: nil, metadata: nil, safety_kit_version: nil, request_options: {})
       #
-      # @param user_id [String] Your stable identifier for the user this content belongs to.
+      # @param content [Array<SafetyKit::Models::ContentCreateParams::Content::UnionMember0, SafetyKit::Models::ContentCreateParams::Content::UnionMember1>] Body param: Content parts to classify together. At most 20 images.
       #
-      # @param content_id [String] Your content identifier.
+      # @param user_id [String] Body param: Your stable identifier for the user this content belongs to.
       #
-      # @param images [Array<String>] Images to classify, each as base64-encoded image bytes, raw or as a data URI. At
+      # @param content_id [String] Body param: 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}] Body param: Additional product context for this content. At most 8KB when serial
       #
-      # @param text [String] User-authored text to classify.
+      # @param safety_kit_version [Symbol, SafetyKit::Models::ContentCreateParams::SafetyKitVersion] Header param: The API version this operation is defined against.
       #
       # @param request_options [SafetyKit::RequestOptions, Hash{Symbol=>Object}, nil]
       #
@@ -36,10 +36,12 @@ module SafetyKit
       # @see SafetyKit::Models::ContentCreateParams
       def create(params)
         parsed, options = SafetyKit::ContentCreateParams.dump_request(params)
+        header_params = {safety_kit_version: "safetykit-version"}
         @client.request(
           method: :post,
           path: "v1/content",
-          body: parsed,
+          headers: parsed.slice(*header_params.keys).transform_keys(header_params),
+          body: parsed.except(*header_params.keys),
           model: SafetyKit::Models::ContentCreateResponse,
           options: options
         )

data/lib/safety_kit/resources/streams.rb

@@ -6,6 +6,12 @@ module SafetyKit
     class Streams
       # Monitor the livestream at the given stream URL. This method returns immediately.
       #
+      # Errors: 400 for an invalid body, with the reason in the message. 401 for a
+      # missing Authorization header. 403 for an invalid API key. 429 when the rate
+      # limit is exceeded. 5xx for transient internal failures. Retry 429 and 5xx with
+      # exponential backoff. Do not retry other 4xx errors, they indicate a problem with
+      # the request.
+      #
       # @overload add(namespace, id:, stream_url:, request_options: {})
       #
       # @param namespace [String] The namespace to ingest stream data into
@@ -43,6 +49,13 @@ module SafetyKit
       # ignored by downstream processing. This method returns immediately after the
       # frame has been accepted for processing.
       #
+      # Errors: 400 for an invalid body or an image that fails validation, with the
+      # reason in the message. 401 for a missing Authorization header. 403 for an
+      # invalid API key. 429 when the rate limit is exceeded. 5xx for transient internal
+      # failures. Retry 429 and 5xx with exponential backoff. Frame ingestion is
+      # idempotent, so a retried request that already succeeded is ignored. Do not retry
+      # other 4xx errors, they indicate a problem with the request.
+      #
       # @overload add_frame(namespace, image_data_uri:, stream_id:, timestamp:, frame_id: nil, metadata: nil, request_options: {})
       #
       # @param namespace [String] The namespace to ingest stream data into
@@ -80,6 +93,13 @@ module SafetyKit
       # correctly with later frames. This method returns immediately after the
       # transcript has been accepted for processing.
       #
+      # Errors: 400 for an invalid body, with the reason in the message. 401 for a
+      # missing Authorization header. 403 for an invalid API key. 429 when the rate
+      # limit is exceeded. 5xx for transient internal failures. Retry 429 and 5xx with
+      # exponential backoff. Transcript ingestion is idempotent, so a retried request
+      # that already succeeded is ignored. Do not retry other 4xx errors, they indicate
+      # a problem with the request.
+      #
       # @overload add_transcript(namespace, stream_id:, text:, timestamp:, transcript_id: nil, request_options: {})
       #
       # @param namespace [String] The namespace to ingest stream data into

data/lib/safety_kit/version.rb

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