moderation_api 2.20.0 → 2.22.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bb51c2dd8cbf252b7777f03017d7d3b4b3afc2a204113f917a40704e8789b5e3
-  data.tar.gz: 67a4613735a19a3c93b42a75f74d5468c29760ee6902e2147d56878d94d79008
+  metadata.gz: 702ad6b875faa58c838f59c5232b99a125ed63502886583bbfa3236e0e447bb2
+  data.tar.gz: c7c420f51bf7be8c8f5442b854f4061df43ae5ffa343303d60db1855ac5beb68
 SHA512:
-  metadata.gz: 6e0af9a126dcf53dd8d3a33a8a1f7f22c3ec1bbde86b735404d7954c9ff07a799b721b5785212c01d1403eb8f861b2786d52d5bf6e352e555aa2f29fefb114c7
-  data.tar.gz: bb6320deed400febf5e17485a176a0e3acf0ac0d3a4715e664de2a7215d5c5d74294c26dc4d47987982db6a3ebbfe980acb0ef30bec2cdb77c1364d3a67b16ef
+  metadata.gz: 4428e4355dc7b2b8e9b5bcf0a2929c36eb5078d02812dff5f1f52d932a38303b5d8bac87167d968475035a5919e037037fe71d4790ad464bee2f90f67460e2fe
+  data.tar.gz: 1383d052a974cf8fbfa1c00f800b1cc7cb2e47790b5efeb517792d97e099d2e800711ac8280f56bdbf37c70ceb6a6220f0b4b8c8be596c8c0f321c769bed0927

data/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 2.22.0 (2026-06-02)
+
+Full Changelog: [v2.21.0...v2.22.0](https://github.com/moderation-api/sdk-ruby/compare/v2.21.0...v2.22.0)
+
+### Features
+
+* **api:** api update ([f04cbbf](https://github.com/moderation-api/sdk-ruby/commit/f04cbbf7be3373c6a08b3e0192e5ba45690e962f))
+
+## 2.21.0 (2026-06-02)
+
+Full Changelog: [v2.20.0...v2.21.0](https://github.com/moderation-api/sdk-ruby/compare/v2.20.0...v2.21.0)
+
+### Features
+
+* **api:** api update ([250e1b4](https://github.com/moderation-api/sdk-ruby/commit/250e1b4849fff5f9dfe39c267b4641c23fc46358))
+
 ## 2.20.0 (2026-06-01)
 
 Full Changelog: [v2.19.0...v2.20.0](https://github.com/moderation-api/sdk-ruby/compare/v2.19.0...v2.20.0)

data/README.md

@@ -15,7 +15,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "moderation_api", "~> 2.20.0"
+gem "moderation_api", "~> 2.22.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/moderation_api/models/content_submit_params.rb

@@ -26,6 +26,18 @@ module ModerationAPI
       #   @return [String, nil]
       optional :channel, String
 
+      # @!attribute client_action
+      #   A recommendation from your own client-side flagging (e.g. a banned-IP list or a
+      #   third-party tool). Feeds the rules engine and can escalate or override the
+      #   recommended action. Does not change whether our analysis flagged the content.
+      #
+      #   @return [ModerationAPI::Models::ContentSubmitParams::ClientAction, nil]
+      optional :client_action,
+               -> {
+                 ModerationAPI::ContentSubmitParams::ClientAction
+               },
+               api_name: :clientAction
+
       # @!attribute content_id
       #   The unique ID of the content in your database.
       #
@@ -70,7 +82,7 @@ module ModerationAPI
       #   @return [Float, nil]
       optional :timestamp, Float
 
-      # @!method initialize(content:, author_id: nil, channel: nil, content_id: nil, conversation_id: nil, do_not_store: nil, metadata: nil, meta_type: nil, policies: nil, timestamp: nil, request_options: {})
+      # @!method initialize(content:, author_id: nil, channel: nil, client_action: nil, content_id: nil, conversation_id: nil, do_not_store: nil, metadata: nil, meta_type: nil, policies: nil, timestamp: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {ModerationAPI::Models::ContentSubmitParams} for more details.
       #
@@ -80,6 +92,8 @@ module ModerationAPI
       #
       #   @param channel [String] Provide a channel ID or key. Will use the project's default channel if not provi
       #
+      #   @param client_action [ModerationAPI::Models::ContentSubmitParams::ClientAction] A recommendation from your own client-side flagging (e.g. a banned-IP list or a
+      #
       #   @param content_id [String] The unique ID of the content in your database.
       #
       #   @param conversation_id [String] For example the ID of a chat room or a post
@@ -345,6 +359,77 @@ module ModerationAPI
         #   @return [Array(ModerationAPI::Models::ContentSubmitParams::Content::Text, ModerationAPI::Models::ContentSubmitParams::Content::Image, ModerationAPI::Models::ContentSubmitParams::Content::Video, ModerationAPI::Models::ContentSubmitParams::Content::Audio, ModerationAPI::Models::ContentSubmitParams::Content::Object)]
       end
 
+      class ClientAction < ModerationAPI::Internal::Type::BaseModel
+        # @!attribute action
+        #   Your recommendation for the content: allow, review, or reject.
+        #
+        #   @return [Symbol, ModerationAPI::Models::ContentSubmitParams::ClientAction::Action]
+        required :action, enum: -> { ModerationAPI::ContentSubmitParams::ClientAction::Action }
+
+        # @!attribute behavior
+        #   How your recommendation combines with ours. Defaults to 'escalate', which only
+        #   applies it when stricter than ours; 'override' replaces ours outright.
+        #
+        #   @return [Symbol, ModerationAPI::Models::ContentSubmitParams::ClientAction::Behavior, nil]
+        optional :behavior, enum: -> { ModerationAPI::ContentSubmitParams::ClientAction::Behavior }
+
+        # @!attribute reason
+        #   A human-readable explanation for your recommendation.
+        #
+        #   @return [String, nil]
+        optional :reason, String
+
+        # @!attribute source
+        #   Where your recommendation came from, e.g. "banned-ip".
+        #
+        #   @return [String, nil]
+        optional :source, String
+
+        # @!method initialize(action:, behavior: nil, reason: nil, source: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {ModerationAPI::Models::ContentSubmitParams::ClientAction} for more details.
+        #
+        #   A recommendation from your own client-side flagging (e.g. a banned-IP list or a
+        #   third-party tool). Feeds the rules engine and can escalate or override the
+        #   recommended action. Does not change whether our analysis flagged the content.
+        #
+        #   @param action [Symbol, ModerationAPI::Models::ContentSubmitParams::ClientAction::Action] Your recommendation for the content: allow, review, or reject.
+        #
+        #   @param behavior [Symbol, ModerationAPI::Models::ContentSubmitParams::ClientAction::Behavior] How your recommendation combines with ours. Defaults to 'escalate', which only a
+        #
+        #   @param reason [String] A human-readable explanation for your recommendation.
+        #
+        #   @param source [String] Where your recommendation came from, e.g. "banned-ip".
+
+        # Your recommendation for the content: allow, review, or reject.
+        #
+        # @see ModerationAPI::Models::ContentSubmitParams::ClientAction#action
+        module Action
+          extend ModerationAPI::Internal::Type::Enum
+
+          REVIEW = :review
+          ALLOW = :allow
+          REJECT = :reject
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
+        # How your recommendation combines with ours. Defaults to 'escalate', which only
+        # applies it when stricter than ours; 'override' replaces ours outright.
+        #
+        # @see ModerationAPI::Models::ContentSubmitParams::ClientAction#behavior
+        module Behavior
+          extend ModerationAPI::Internal::Type::Enum
+
+          OVERRIDE = :override
+          ESCALATE = :escalate
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+
       # The meta type of content being moderated
       module MetaType
         extend ModerationAPI::Internal::Type::Enum

data/lib/moderation_api/models/content_submit_response.rb

@@ -907,6 +907,7 @@ module ModerationAPI
           RULE_MATCH = :rule_match
           RULE_DEFAULT = :rule_default
           RULE_FALLBACK = :rule_fallback
+          CLIENT_OVERRIDE = :client_override
 
           # @!method self.values
           #   @return [Array<Symbol>]